> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alicein.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your agent

> Wire your own Claude Code into the project record.

Alice.In does not run an AI agent for you. It connects to the [Claude Code](https://claude.com/claude-code) you already use, on your machine and your own subscription. The app's **Connect a repo** panel walks you through it and lists what is already connected.

Connecting adds two plain files to your project, which you can read, edit or delete at any time:

* **`.mcp.json`** — registers the connection to your workspace.
* **A block in `CLAUDE.md`** — teaches your agent the protocol: orient from the project record, log what it does, pull queued work, and propose changes for your approval.

Nothing runs in the background, and nothing about your existing setup changes.

## What changes in your sessions

<CardGroup cols={2}>
  <Card title="It arrives oriented" icon="compass">
    Say **"get the alicein context"** and your agent knows the whole project state — phases, active work, recent decisions, what is waiting on you.
  </Card>

  <Card title="It leaves a record" icon="pen">
    Work normally. Your agent logs what it did and why into your project record, so nothing you build stays unexplained.
  </Card>

  <Card title="It picks up queued work" icon="inbox-in">
    Press **Queue for agent** on a card, then say **"check my alicein queue"**. The card arrives with its full context pack.
  </Card>

  <Card title="It proposes, you decide" icon="check">
    Changes to plans and decisions land in [Needs you](/using/needs-you) for you to ratify. Nothing structural changes without you.
  </Card>
</CardGroup>

## Using a different tool

Any card offers its context as markdown you can copy and paste into Cursor, ChatGPT, or whatever you prefer. You lose the automatic logging, not the context.

## Your work shows on the map

Once connected, the commits your agent records are matched to your modules by the files they changed, so recently worked parts of your system read as active on the [factory map](/using/factory-map).

You can connect more than one repository — **Connect a repo** in the app shows what is already connected.

<Note>
  We never see or spend your Claude account, and we never ask for its credentials. The connection carries your project's record, nothing else.
</Note>