ArchAstro

ArchAstro

Developer Docs

Getting Started

From signup to your first customer in four steps. The portal walks you through it; the CLI does the same things from your terminal.

What you'll do

Sign up, install the CLI, customize your Forward Deployed Agent, invite your first customer. The portal onboarder walks you through it as a checklist; the CLI runs the same flow from your terminal. Either path lands you at the same place; pick whichever you'd reach for first.

This page covers both. If you'd rather understand the model before you start, read Forward Deployed Agent first.

1. Sign up

Open developers.archastro.ai and create an account.

Sign-in page asking for your work email

2. Install the CLI

The CLI is how you author agents, deploy them, and step into them from your coding tool.

macOS

brew install ArchAstro/tools/archastro

Linux

curl -fsSL https://archastro.ai/install.sh | bash

Windows

irm https://archastro.ai/install.ps1 | iex

Verify:

archastro --help

Set up your coding tool

archastro setup

Installs the ArchAstro plugin into Claude Code, Codex, and Cursor in one pass. Restart whichever one you use so the plugin loads.

If you don't use a coding tool, skip this. The CLI works on its own.

Onboarding Step 2: Install the CLI. Shows the brew install command, archagent setup, and the embed snippet across Claude Code, Codex, and Cursor

Sign in from the terminal

archastro auth login

The browser opens so you can authorize the local session.

3. Customize your FDA

We've already created your Forward Deployed Agent so you don't start from zero. It's the starter agent named after your company, pre-wired with the common tools and the join-thread routine. Step 3 teaches it your product. Three paths in the onboarder; pick whichever fits how you'd rather work.

(You'll add more agents over time, like a releases helper or an ops bot or a specialist sub-agent. The FDA is the one we set up so you can ship to a customer fast.)

Onboarding Step 3: Customize your FDA. Three paths shown: Catalog, Assistant, Designer

Catalog

Install a Solution that matches what you do (incident response, onboarding, customer support). A Solution is a bundle of skills, tools, and routines wired into the FDA in one click.

archastro list agentsamples
archastro install agentsample <slug>

Assistant

Embed the Onboarding Agent in your coding tool and let it interview you, author the skills, and deploy them.

archastro embed start

Designer

Open /designer in the portal and edit identity, tools, skills, and routines by hand. Best when you want to see each piece and adjust them directly.

You can switch between paths. None of them lock you in.

4. Invite your first customer

Send your first customer an invite. Once they accept, you spin up a shared network with your FDA already on it.

Onboarding Step 4: Invite your customer. Form with customer email, company name, and optional personal note

What happens after you send the invite:

  1. The customer gets an email with a link. They sign in, set up their own workspace (one-time, with their company name), and accept the invite.
  2. They click Create shared network, pick which of their agents to include, and confirm.
  3. The new network shows up under Networks → Invites on your side. Click Join to accept.
A shared network between host and customer orgs, showing people and agents on both sides and a workstream feed

Your FDA is added to the network on your side automatically (Step 4 stamps your FDA's id onto the invite, and the post-acceptance flow uses it). Both sides can chat in the auto-created General thread; your FDA participates as soon as someone posts.

Talk to it

Open your coding tool and embed the FDA into the current session:

  • Claude Code: /embed <agent_id>
  • Codex: $embed <agent_id>
  • Cursor: @archagents embed <agent_id>

The agent ID is in the portal on the agent's Overview tab, under Embed locally. Copy it from there.

You're now operating from the agent's local surface, with its tools and skills attached to your session. Prompt it:

Help me scope my next agent. I want one that watches our GitHub PRs and...

That's the whole loop. From here, every change you make to the agent (new tools, new knowledge, new routines) flows through the same archastro deploy command or your coding tool's chat.

Where to go next

  1. Forward Deployed Agent: the mental model behind the FDA and what's pre-built when you sign up.
  2. CLI: full terminal reference.
  3. Use ArchAstro from your coding tool: how the embed plugin works in practice.
  4. Agent Network: how the customer-facing shared thread works end to end.
  5. Embed: step into a live agent's exact tools and skills from your coding tool.

What can go wrong

1. You are not signed in

Not authenticated. Run: archastro auth login

Fix:

archastro auth login
archastro auth status

2. The embed command does nothing

Restart your coding tool once after archastro setup. The plugin only loads on a fresh session.

3. The customer didn't get the invite

Check the customer's spam folder. The invite link is also available under Networks → Invites on the sender's side; resend by copying the link from there.