Skip to main content

ideon agent

What This Command Does​

ideon agent manages local runtime integration registrations and readiness checks for Ideon agent usage.

Usage​

ideon agent install <runtime> [--dry-run]
ideon agent uninstall <runtime> [--dry-run]
ideon agent status [--json]

Supported and Unsupported Runtimes​

Supported runtime ids:

  • claude
  • chatgpt
  • gemini
  • generic-mcp

Explicitly unsupported runtime ids:

  • cursor
  • vscode

Subcommands​

ideon agent install​

Registers a runtime integration profile.

ideon agent install claude
ideon agent install generic-mcp --dry-run

ideon agent uninstall​

Removes a runtime integration profile.

ideon agent uninstall claude
ideon agent uninstall chatgpt --dry-run

ideon agent status​

Prints installed runtimes and readiness checks.

ideon agent status
ideon agent status --json

Status includes:

  • installed runtimes
  • integration sync-check status
  • MCP tool contract count
  • skill contract count (internal skill metadata entries, for example ideon-write-primary)
  • config surface readiness

Output and Exit Codes​

Exit codeMeaning
0Command completed successfully.
1Runtime id or state validation failed, or a runtime error occurred.
130Command interrupted by Ctrl+C.

Versioning and Deprecation Notes​

  • Current behavior applies to Ideon 0.1.6.
  • Runtime registration is idempotent and persisted in the local integration store.