Skip to content

Get started with Kody

Step 1

Connect Muse

Kody plugging a cable into a warmly glowing port on a laptop
Log in to connect Muse

Add Kody to Muse Code via ~/.config/muse/settings.json, then sign in with muse mcp login (Muse MCP docs).

~/.config/muse/settings.json
{
  "schema_version": 1,
  "mcp_servers": {
    "kody": {
      "transport": "streamable_http",
      "url": "https://kody.codes/mcp",
      "mode": "optional"
    }
  }
}
muse mcp login
muse mcp login kody

After OAuth succeeds, headless Muse may ask you to paste a localhost URL into the Muse chat.

Need help? Muse connection docs

Do not paste npx @kodycodes/cli install into Muse chat — that runs in Muse's Linux VM and cannot configure Muse.

Authenticate Kody before you continueRun muse mcp login kody after saving ~/.config/muse/settings.json, then complete OAuth when prompted. After OAuth succeeds, you may need to paste a localhost URL into the Muse chat.Approve the kody.codes OAuth window. This is the step that connects your agent to your factory.

Add Kody to Muse Code via ~/.config/muse/settings.json, then sign in with muse mcp login (Muse MCP docs).

~/.config/muse/settings.json
{
  "schema_version": 1,
  "mcp_servers": {
    "kody": {
      "transport": "streamable_http",
      "url": "https://kody.codes/mcp",
      "mode": "optional"
    }
  }
}
muse mcp login
muse mcp login kody

After OAuth succeeds, headless Muse may ask you to paste a localhost URL into the Muse chat.

Need help? Muse connection docs

Muse Code is for a computer. Change selection and pick a host with a mobile app, or run these steps later on a computer. Do not paste npx @kodycodes/cli install into Muse chat — that runs in Muse's Linux VM and cannot configure Muse.

Authenticate Kody before you continueOn a computer, merge Kody into ~/.config/muse/settings.json, run muse mcp login kody, then complete OAuth. After OAuth succeeds, you may need to paste a localhost URL into the Muse chat.Approve the kody.codes OAuth window. This is the step that connects your agent to your factory.

Join the Discord