Skip to main content
Setup is a conversation with your own coding agent. It reads your repos, asks what it could not read, and writes a first draft of your project. You correct the draft.
1

Open the invite

Open alicein.app/start and sign in with Google. There is no separate token to copy.You land on Connect. The workspace already exists, and the command on the page already carries your token. Treat that command like a password: do not paste it into a chat or a ticket.Bookmark alicein.app/workspace. That is the map. It starts empty until you onboard.
2

Connect your agent

Have Claude Code, Codex, or Grok Build installed and signed in first, on your own account. You also need Node 18 or newer.On the Connect page, pick macOS / Linux or Windows, press Copy command, and paste it into a terminal inside the repo you work in — not your home folder, not the browser’s address bar.Check it took: run /mcp in Claude Code and you should see alicein. In Grok, grok inspect. Full detail, including adding a second repo later, in Connect your agent.
3

Let it onboard you

In that session:
It lists your repos, asks which belong to this project, reads them on your machine, then interviews you in short rounds. Each question comes with the answer it would give, so you can agree or correct.You approve three things before they save: what the project is, the plan (phases and enablers), and the factory map. See Onboarding.If you already track work in Linear, say so in the interview and it comes across in the same session.
4

Correct it on the map

Open alicein.app/workspace, or refresh it if it is already open. Your agent should also hand you this link when onboarding finishes.You land on the project map. Phases run left to right — scroll or zoom out for the later ones. Each enabler shows cards done out of total; click it to see the cards. Drag, rename, and delete until the draft is yours.
5

Look around

Three views and a chat:
  • The project map — your plan: phases, enablers and cards.
  • The factory map — your system: what its parts are and how they connect. Off until you turn Show factory tab on in Settings.
  • The knowledge view — everything your project knows, and what led to what.
  • Alice, bottom right — “where are we?”, “what needs me?”, “why did we do X?”
Needs you is the one queue where things wait for your judgment. Press ? for the keyboard shortcuts.
6

Hand it work

Press Queue for agent on a card. In a terminal, say “check my alicein queue” — the card arrives with its full context pack, and comes back to you for review. See the agent queue.

​
Your first hour

  1. Onboard, and answer the why questions yourself.
  2. Fix the map: right phases, right names, nothing made up.
  3. Ask your agent what to do next.
  4. Queue one card and watch it come back for review.

​
What to expect

  • Your agent runs on your machine and your own subscription. We never see it or spend it.
  • The reading step is local. No model sees your code but your own agent.
  • Your workspace is isolated per account. We export or delete everything on request.