sekuire run

Run your agent locally with automatic installation and bootstrap.

Usage

bash

sekuire run [OPTIONS]

Options

Option	Description
`-c, --cmd <CMD>`	Command to run agent (e.g., npm start)
`--workspace <ID>`	Workspace ID (defaults to config)
`--backend <URL>`	Backend URL (default: http://localhost:5556)
`--agent <ID>`	Sekuire agent ID (defaults to manifest hash)
`--install-token <TOKEN>`	Skip token minting
`--upstream-url <URL>`	Override upstream URL
`--capability <CAP>`	Capabilities to register (repeatable)
`--heartbeat-interval <SEC>`	Heartbeat interval (default: 60)
`--no-heartbeat`	Disable automatic heartbeats

What It Does

Installs the agent in the workspace
Bootstraps with install token
Registers capabilities
Starts heartbeat loop
Runs your agent command

Examples

Basic Run

Uses sekuire.yml configbash

sekuire run

With Custom Command

Python agentbash

sekuire run --cmd "python main.py"

Node.js agentbash

sekuire run --cmd "npm start"

Rust agentbash

sekuire run --cmd "cargo run --release"

Production Setup

Full configurationbash

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

Heartbeat

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

Default: every 60 secondsbash

sekuire run

Custom intervalbash

sekuire run --heartbeat-interval 30

Disable heartbeatsbash

sekuire run --no-heartbeat

Configuration Precedence

Command-line flags (highest priority)
Environment variables
sekuire.yml manifest
~/.sekuire/auth.json defaults

Troubleshooting

"Workspace not configured"

bash

sekuire config set workspace.id ws_your_workspace_id

"Not authenticated"

bash

sekuire login

"Agent not found"

bash

sekuire push  # Push your agent first