CLI Reference

Every Janee command, with options and examples.

janee serve

Start the MCP server. This is the main command — it exposes Janee's tools to your MCP client.

janee serve

In most setups, you don't run this directly — your MCP client config handles it:

{
  "mcpServers": {
    "janee": {
      "command": "npx",
      "args": ["@true-and-useful/janee", "serve"]
    }
  }
}

janee add

Add a new service credential.

# HTTP proxy mode (default)
janee add stripe --key "sk_live_xxx" --base-url "https://api.stripe.com"

# Exec mode (CLI tools)
janee add twitter --exec \
  --key "tvly-xxx" \
  --allow-commands "bird,tweet-cli" \
  --env-map "TWITTER_API_KEY={{credential}}"

# GitHub App (short-lived tokens)
janee add github --github-app \
  --app-id 12345 \
  --private-key-path ~/.janee/github-app.pem \
  --installation-id 67890

Options

• --key <value> — API key or token
• --base-url <url> — Base URL for HTTP proxy mode
• --header <name> — Header name for the credential (default: Authorization)
• --prefix <value> — Header value prefix (default: Bearer)
• --exec — Use exec mode instead of HTTP proxy
• --allow-commands <list> — Comma-separated allowed executables (exec mode)
• --env-map <mapping> — Environment variable mapping (exec mode)
• --work-dir <path> — Working directory for subprocesses (exec mode)
• --timeout <seconds> — Max execution time (exec mode, default: 30s)
• --github-app — Use GitHub App authentication
• --app-id <id> — GitHub App ID
• --private-key-path <path> — Path to GitHub App private key
• --installation-id <id> — GitHub App installation ID

janee list

List all configured services.

janee list

# Output:
# stripe     (proxy)  https://api.stripe.com
# github     (app)    github-app:12345
# twitter    (exec)   bird, tweet-cli

janee remove

Remove a service and its stored credentials.

janee remove stripe

janee sessions

List active agent sessions.

janee sessions

# Output:
# ID          CAPABILITY      EXPIRES         REQUESTS
# a1b2c3d4    stripe-readonly 45m remaining   12
# e5f6g7h8    github-repos    12m remaining   3

janee revoke

Revoke active sessions immediately.

# Revoke a specific session
janee revoke a1b2c3d4

# Revoke all sessions
janee revoke --all

janee audit

View the audit log of agent requests.

# Recent entries
janee audit

# Filter by capability
janee audit --capability stripe-readonly

# Last N entries
janee audit --last 50