Jcode — Configuration Reference

Jcode configuration lives at ~/.jcode/config.toml (or $JCODE_HOME/config.toml). Everything has a default, so the file can start empty and grow as you override things. MCP config is separate, in ~/.jcode/mcp.json (global) and .jcode/mcp.json (project).

config.toml

The main sections:

A small example:

[provider]
default_provider = "openai"
default_model = "gpt-5"

[display]
centered = true

[keybindings]
side_panel_toggle = "alt+m"
new_terminal = "alt+enter"

[features]
memory = true
swarm = true

Provider Profiles

Named profiles fill in base URL and key variable for OpenAI-compatible services. Built-ins include openrouter, deepseek, moonshotai, huggingface, nebius. Add a custom one without putting the key in shell history:

printf '%s' "$MY_API_KEY" | jcode provider add my-api \
  --base-url https://llm.example.com/v1 \
  --model my-model-id \
  --api-key-stdin \
  --set-default

Local servers without auth: pass --no-api-key and a localhost base URL. Per-provider keys can also live in ~/.config/jcode/*.env.

MCP Server Configuration

MCP config lives in ~/.jcode/mcp.json (global) and .jcode/mcp.json (project-local). Jcode also reads Claude Code's configs (~/.claude.json and .mcp.json at the repo root) and imports servers from Claude Code and Codex configs on first run.

{
  "mcpServers": {
    "filesystem": {
      "command": "/path/to/mcp-server",
      "args": ["--root", "/workspace"],
      "env": {}
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Notes:

• Only stdio (command-based) servers are supported today; HTTP and SSE entries are recognized and skipped.
• Configured MCP tools are advertised the moment a session starts from an on-disk schema cache — a slow server handshake never blocks startup or invalidates the prompt cache.
• Connections are connect-on-first-call in the background; a call that needs a not-yet-connected server transparently waits for the handshake.

Files Jcode Reads

Memory Configuration

Memory is a [features] toggle. When enabled, every turn and response is embedded as a semantic vector; each turn queries a graph of memories via cosine similarity and injects related entries into the conversation. An optional memory sideagent ([agents]) verifies relevance and does more retrieval work before injection.

[features]
memory = true

[agents]
memory_sidecar = true   # spawn a sideagent to verify memory relevance

Swarm Configuration

Swarms let you spawn coordinated multi-agent teams. Policy lives in swarm-prompt.md files — [agents] in config.toml controls routing and limits:

[agents]
spawn_mode = "manual"    # or "auto"
concurrency_cap = 8      # max parallel swarm agents

Jcode detects file conflicts between swarm members and notifies agents when another member changed a file they'd read. Use Alt+N in the TUI to focus the inline swarm panel.

Remote Gateway

The daemon can expose a WebSocket gateway for paired thin clients (built for Tailscale/LAN reachability). Off by default:

[gateway]
enabled = true   # listens on port 7643

Pair devices with:

jcode pair            # prints a 6-digit code and QR (5 minute TTL)
jcode pair --list     # show paired devices
jcode pair --revoke <device>

Tokens are stored hashed on the server. Remote machines can run the server and forward its Unix socket over SSH:

# on the remote
jcode serve --server-name mybox

# on your laptop
ssh -N -L /tmp/jcode-mybox.sock:/run/user/1000/jcode.sock mybox &
jcode --socket /tmp/jcode-mybox.sock -C /local/checkout --remote-working-dir /remote/checkout

Keybindings

Every binding is configurable under [keybindings] using values like "alt+m". Set a binding to "" to disable it.

Environment Variables

Related Pages

• MCP Setup in Jcode — step-by-step MCP configuration
• Jcode Getting Started — Installation and provider setup
• Prompt Engineering in Jcode — hill-climbable goals and todo discipline
• Memory, Swarms & Self-Dev — advanced workflows
• MCP Section — Browse MCP servers
• Agent Skills (Agents Section) — cross-tool SKILL.md standard