Skip to main content

sekuire run

Run your agent locally with automatic installation and bootstrap.

Usage​

sekuire run [OPTIONS]

Options​

OptionDescription
-c, --cmd <CMD>Command to run agent (auto-detects if omitted)
--workspace <ID>Workspace ID (defaults to config)
--backend <URL>Backend URL (default: https://api.sekuire.ai)
--agent <ID>Sekuire agent ID (defaults to manifest hash)
--install-token <TOKEN>Use existing install token (skip minting)
--upstream-url <URL>Override upstream URL (default: manifest or http://localhost:8000/a2a/tasks)
--capability <CAP>Capabilities to register (repeatable)
--heartbeat-interval <SEC>Heartbeat interval (default: 60)
--no-heartbeatDisable automatic heartbeats

What It Does​

  1. Installs the agent in the workspace
  2. Bootstraps with install token
  3. Registers capabilities
  4. Starts heartbeat loop
  5. Runs your agent command

Examples​

Basic Run​

Uses sekuire.yml config
sekuire run

With Custom Command​

Python agent
sekuire run --cmd "python main.py"
Node.js agent
sekuire run --cmd "npm start"
Rust agent
sekuire run --cmd "cargo run --release"

Production Setup​

Full configuration
sekuire run \
  --workspace ws_prod_12345 \
  --backend https://api.sekuire.ai \
  --capability "data_analysis" \
  --capability "code_generation" \
  --heartbeat-interval 30

Heartbeat​

The CLI sends periodic heartbeats to indicate the agent is alive:

Default: every 60 seconds
sekuire run
Custom interval
sekuire run --heartbeat-interval 30
Disable heartbeats
sekuire run --no-heartbeat

Configuration Resolution​

  • Workspace: --workspace overrides ~/.sekuire/auth.json (config workspace.id)
  • Capabilities: --capability overrides sekuire.yml capabilities.provides
  • Upstream URL: --upstream-url overrides sekuire.yml a2a.upstream_url

Troubleshooting​

"Workspace not configured"​

sekuire config set workspace.id ws_your_workspace_id

"Not authenticated"​

sekuire login

"Agent not found"​

sekuire push  # Push your agent first