Skip to content
CodeBook

Connect Claude

Install, sign in to, update or remove the CodeBook plugin in Claude Code. Connect Claude chat to the same Bookbag account over MCP.

Use Claude Code to run stories in a checkout, open the Factory pane, or type /factory commands. Use the CodeBook connector in Claude chat to read a board or request cloud work in plain language. Both sign in to the same Bookbag account. Open CodeBook once with that account so it can find your factories. Sign in to CodeBook

Claude Code

Install the plugin

  1. Open Terminal on macOS, Windows Terminal with PowerShell or WSL, or your Linux shell. Run claude --version. If the command is missing, install Claude Code for the operating system you will use and open a new terminal. Claude Code setup
  2. Run these commands at the shell prompt. The first adds Bookbag’s public GitHub marketplace. The second installs the plugin in your Claude Code user profile, available across your projects.
claude plugin marketplace add bookbaghq/codebook-plugin
claude plugin install codebook@codebook --scope user
claude plugin list
  1. Look for codebook@codebook, its version, Scope: user, and enabled. To inspect the installed components, run claude plugin details codebook@codebook. It lists the factory-manager skill, the factory-worker and benchmark-worker agents, and the codebook MCP server.
  2. Start Claude Code with claude. In an existing interactive session, enter /reload-plugins or start a new session. Enter /factory help in Claude Code to see the commands. Manage installed Claude Code plugins

In the Code view of Claude Desktop you can also open + → Plugins → Add marketplace, enter bookbaghq/codebook-plugin, and install codebook. In an interactive Claude Code terminal, /plugin opens the plugin manager. The GitHub repository is the marketplace source. Its installed plugin ID is codebook@codebook. Bookbag’s plugin and source

Saved conversations on Windows

In the PowerShell profile where you start Claude Code, run Get-Command sh, tail, head, grep. Conversation capture uses these Git for Windows utilities to read transcript files in ranges and to find earlier sessions for backfill. If PowerShell cannot find them, locate the Git installation’s usr\bin directory. For a default install, the following changes the PATH for this terminal session.

$env:Path = "$env:ProgramFiles\Git\usr\bin;$env:Path"
Get-Command sh, tail, head, grep
claude

Inside Claude Code, type /factory capture status to see the current setting, saved blocks and any upload error. In WSL, start Claude and run the plugin in the same distribution where you installed it.

Sign in

Inside Claude Code, open /mcp, select plugin:codebook:codebook, choose Authenticate, and finish the Bookbag sign-in in your browser. From a shell you can start the same flow with this command.

claude mcp login plugin:codebook:codebook

On a remote terminal use claude mcp login --no-browser plugin:codebook:codebook and follow the prompts privately. Claude Code manages the resulting credentials. The plugin manifest already provides the HTTPS server address.

Check that it works

Run /factory list inside Claude Code. Your factories should match the ones visible on the CodeBook website for the same account. Then enter /factory to pick a factory. To find a story before it enters a station, choose View backlog in the pane or enter /factory backlog Payments. Follow the story using the command in its row; reading it does not start a worker. For a cloud work order you already know, /factory report Payments WO-7 reads its latest state. Replace the example factory and order with yours. Command reference

Update, disable or remove

To update a user-scope installation, refresh the catalogue and update the plugin, then reload plugins in Claude Code.

claude plugin marketplace update codebook
claude plugin update codebook@codebook --scope user
claude plugin list

To pause the plugin locally, run claude plugin disable codebook@codebook --scope user. Re-enable it with claude plugin enable codebook@codebook --scope user. To sign out, uninstall, and remove the marketplace from this profile, run these commands in order.

claude mcp logout plugin:codebook:codebook
claude plugin uninstall codebook@codebook --scope user
claude plugin marketplace remove codebook

Use the scope shown in claude plugin list if your installation is project- or local-scope. Closing or uninstalling a client leaves an approved cloud work order with CodeBook. Pause or cancel the order in CodeBook if you want that work to stop.

Auto mode and background permissions

When the pane says Not reached, first try /factory list. If sign-in works and Auto mode is blocking a background read, add the needed tool to the existing permissions.allow list in your Claude Code settings. Keep the tool names specific. For example, these allow listing factories and reading a followed story.

{
  "permissions": {
    "allow": [
      "mcp__plugin_codebook_codebook__list_factories",
      "mcp__plugin_codebook_codebook__story_status",
      "mcp__plugin_codebook_codebook__story_trail"
    ]
  }
}

Additional operations have their own tools. A board uses factory_board, a work-order report uses work_orders, and checkout recognition uses checkout_factory, each with the same mcp__plugin_codebook_codebook__ prefix. Transcript upload (capture_transcript) and claiming a local proof (claim_proof) are separate capabilities. Enable those if you intend to save transcripts or run proofs. Checkout, capture and proof settings

Claude chat: claude.ai, desktop and mobile

A remote connector belongs to your Claude account. Start in Claude on the web so the setup controls are visible.

  1. Open Customize → Connectors and choose Add custom connector or Add → Custom → Web, depending on the interface. On Team or Enterprise, an authorized administrator first adds the connector under Organization settings → Connectors.
  2. Name it CodeBook and enter https://app.codebook.work/mcp. Review the detected OAuth settings. Choose sign-in and use automatic registration if the client asks how to register. CodeBook uses Bookbag OAuth and does not give you a client secret to paste.
  3. Choose Connect and sign in with the Bookbag account you use on CodeBook. Team members connect individually after the administrator adds the connector.
  4. Open a conversation, enable CodeBook under + → Connectors, and ask “Which CodeBook factories can I see?” Compare the result with CodeBook before starting work. Connector availability depends on your plan and workspace policy. Anthropic’s custom connector guide

To stop using CodeBook in a conversation, switch it off under + → Connectors. To end your account connection, disconnect it in Claude’s connector settings. To remove its definition, open Customize → Connectors and use the connector’s Remove action. On a managed workspace, an authorized administrator removes the organization-wide connector in Organization settings → Connectors. Anthropic’s connector removal instructions

What you are allowing

Bookbag asks for access to read factories, run work and, when requested, manage factory configuration. CodeBook also checks your workspace membership and role. A viewer can read. A station decision requires permission for that station. Publishing a proposal or confirming a review can change the factory, so read the requested action and its effect.

If something is off

  • Unknown command /factory. Check you are in Claude Code, run claude plugin list in the shell, enable the plugin if necessary, then reload it. In Claude chat, ask the connector in plain language.
  • Plugin or marketplace cannot be found. Add the GitHub marketplace first, use the installed ID codebook@codebook, and check whether your organization restricts marketplaces. When using WSL, run install and verification in the same WSL profile where you start Claude.
  • Sign-in works but factories are missing. Check the Bookbag identity, open the CodeBook website, and confirm the same workspace is available there. For an expired sign-in or a missing permission, run claude mcp logout plugin:codebook:codebook, then run the login command above.
  • An updated tool is missing. Update the plugin and reload the Claude Code session. For a server-side tool change, reconnect CodeBook in /mcp, or disconnect and reconnect it under Claude chat’s Connectors settings. Using CodeBook from chat