abadge agent

`abadge agent add`

Register a new agent. Generates an Ed25519 keypair on-device, stores the private key in ~/.abadge/agents/, and uploads the public key. For local_cli and local_mcp kinds, the agent ID and private-key path are also written to the matching localAgents.* config slot so that abadge run and the MCP server find them automatically.

abadge agent add --name dev-laptop
abadge agent add --name dev-laptop --kind local_cli
abadge agent add --name mcp-host --kind local_mcp
abadge agent add --name ci-bot --kind remote
abadge agent add --name ci-bot --kind remote --bootstrap     # issue a one-time bootstrap token
abadge agent add --name ci-bot --kind remote --public-key ./key.jwk

Flag	Required	Description
`-n, --name <name>`	yes	Agent display name
`-k, --kind <kind>`	no	`local_cli` (default), `local_mcp`, or `remote`
`-d, --description <text>`	no	Optional description (stored in `metadata.description`)
`--bootstrap`	no	Issue a one-time bootstrap token instead of generating a local keypair
`--public-key <path>`	no	Path to an existing Ed25519 public-key JWK to enroll
`--mcp-config`	no	After registering a `local_mcp` agent, print a Claude Desktop config snippet
`--json`	no	Print raw JSON

Agents authenticate only with Ed25519 keypair sessions. There is no long-lived agent API key.

`--mcp-config` (local_mcp only)

abadge agent add --kind local_mcp --name claude-desktop --mcp-config

{
  "mcpServers": {
    "abadge": {
      "command": "/Users/you/.abadge/bin/abadge-mcp",
      "env": {
        "ABADGE_API_URL": "https://api.abadge.io",
        "ABADGE_AGENT_ID": "agt_...",
        "ABADGE_PRIVATE_KEY_PATH": "/Users/you/.abadge/agents/agt_....ed25519.jwk"
      }
    }
  }
}

The binary path defaults to ${ABADGE_INSTALL_DIR:-~/.abadge/bin}/abadge-mcp.

Keypair registration

Generate keypair

The CLI uses WebCrypto to generate an Ed25519 keypair locally.

Upload the public key

POST /v1/agents is called with publicKey (JWK JSON) and metadata.

Store the private key

Written to ~/.abadge/agents/<agent-id>.ed25519.jwk with 0600 permissions inside a 0700 directory.

Update config

For local_cli and local_mcp agents, ~/.abadge/config.json gets localAgents.cli or localAgents.mcp populated.

Remote agents skip the config step — the CLI prints the agent ID, kind, and path to the private-key file, plus a warning that you must configure the remote service with those credentials yourself.

`abadge agent list`

abadge agent list
abadge agent list --json

Output columns: ID, Name, Kind, Locality, Enabled, Created.

`abadge agent rm <agent-id>`

Revoke an agent. Invalidates all active abs_... sessions and disables future authentication.

abadge agent rm <agent-id>

Permissions are not deleted; they remain visible (and useless) until the agent is removed or re-enabled.

`abadge agent mcp-config <agent-id>`

Print the Claude Desktop config snippet for an already-registered local_mcp agent.

abadge agent mcp-config agt_...

The agent is resolved from the API (in the active organization), so this works even when the agent was registered with --json (which does not write the local mcp config slot). It requires the agent’s private key to exist locally at ~/.abadge/agents/<agent-id>.ed25519.jwk — the path abadge agent add writes. If the key file is missing, the command errors and explains that the key must exist on this machine. The command also rejects an id that resolves to a non-local_mcp agent.

Deprecated aliases

For backwards compatibility:

Deprecated	Canonical
`abadge agent register`	`abadge agent add`
`abadge agent revoke`	`abadge agent rm`

The deprecated verbs print a deprecation notice on stderr and re-dispatch to the canonical verb.

Getting started

Authentication

Local daemon

Resources

Runtime

Data movement

`abadge agent add`

`--mcp-config` (local_mcp only)

Keypair registration

`abadge agent list`

`abadge agent rm <agent-id>`

`abadge agent mcp-config <agent-id>`

Deprecated aliases

​abadge agent add

​--mcp-config (local_mcp only)

​Keypair registration

​abadge agent list

​abadge agent rm <agent-id>

​abadge agent mcp-config <agent-id>

​Deprecated aliases

​Related

`abadge agent add`

`--mcp-config` (local_mcp only)

Keypair registration

`abadge agent list`

`abadge agent rm <agent-id>`

`abadge agent mcp-config <agent-id>`

Deprecated aliases

Related