symbi-cli

Command-line tooling for the Symbiont JavaScript/TypeScript SDK. Drive the Symbiont runtime from your shell — manage agents, run development helpers, handle auth.

Distinct from symbi, the Rust-native runtime binary. symbi-cli is a thin Node-based helper that speaks to the runtime over its HTTP API; symbi is the runtime itself.

Install

npm install -g symbi-cli

Or use npx:

npx symbi-cli agent list

Configuration

export SYMBIONT_API_KEY=...
export SYMBIONT_API_URL=http://localhost:8080/api/v1

Or create ~/.symbiont/config.json:

{
  "apiKey": "...",
  "apiUrl": "http://localhost:8080/api/v1"
}

Examples

# Authenticate and verify the runtime is reachable
symbi-cli auth login
symbi-cli auth whoami

# Agent lifecycle
symbi-cli agent list
symbi-cli agent create --file ./my-agent.json
symbi-cli agent exec <agent-id> --input '{"text":"hello"}'

# Development helpers
symbi-cli dev watch ./agents/

Programmatic use

import { program } from 'symbi-cli';
program.parse(['agent', 'list']);

Utilities from symbi-cli/utils/* — config loading, error handling, output formatting — are re-exportable for downstream tools.

See also

• symbi — the Rust-native Symbiont runtime binary
• symbi-core — the programmatic client symbi-cli wraps
• SDK README
• docs.symbiont.dev/getting-started — full installation options

License

Apache 2.0. See LICENSE.