Use
Assistant
The ⌘J sidebar that runs each person's own Claude Code, and how to pair a computer with it.
How it works
The assistant is a chat sidebar, opened from any workspace page with ⌘J (Ctrl+J). It drives each person's own agent CLI, Claude Code first, on their own computer, with their own login and subscription. The agent works in the workspace through the MCP server with that person's permissions.
The server never calls an AI API and holds no AI credentials. A small runner on the person's computer picks up their prompts, runs the CLI and posts its output back.
Setup
- Install Claude Code and sign in by running
claudeonce. - In the app, open the user menu and choose Assistant. Name the computer, choose whether the assistant may change things or only look them up, and get a pairing code. Codes are single-use and last ten minutes.
- On that computer, from a checkout of the repository:
pnpm install && pnpm --filter @knotworking/runner build
node apps/runner/dist/cli.js pair ABCD-EFGH --url https://knot.example.com
node apps/runner/dist/cli.js start # keep it running
The assistant is a module granted person by person: owners and admins have it, and give it to others under module access.
Privacy
Chats are personal. They are never synced to teammates and their routes refuse API tokens. A person's subscription is only ever used by their own runner, for their own prompts.