falcon CLI reference
Every command and flag, generated from the cobra command tree.
falcon
Section titled “falcon”FalconEyes — your agents, your devices, your cloud. One private network.
falconfalcon agent
Section titled “falcon agent”Agent runtime recipes and local supervisor
falcon agentfalcon agent add
Section titled “falcon agent add”Register an agent runtime recipe
falcon agent add [name]falcon agent attach
Section titled “falcon agent attach”Attach an existing localhost OpenAI-compatible endpoint
falcon agent attach [name] [flags]| flag | default | description |
|---|---|---|
--health-url | — | optional health URL (default: |
--model | — | served model name |
--register | false | register the attached llm service on the current mesh node |
--url | — | OpenAI-compatible localhost base URL, e.g. http://127.0.0.1:18000/v1 |
falcon agent doctor
Section titled “falcon agent doctor”Run local runtime preflight checks
falcon agent doctorfalcon agent logs
Section titled “falcon agent logs”Show logs for a Falcon-managed Docker runtime
falcon agent logs [name] [flags]| flag | default | description |
|---|---|---|
--tail | 120 | number of log lines |
falcon agent smoke
Section titled “falcon agent smoke”Run streaming, multi-turn, memory, and loop smoke checks
falcon agent smoke [name] [flags]| flag | default | description |
|---|---|---|
--loops | 3 | durable loop iterations |
--timeout | 3m0s | smoke timeout |
falcon agent start
Section titled “falcon agent start”Start a known local AI runtime profile
falcon agent start [flags]| flag | default | description |
|---|---|---|
--model | — | model to load or pull (default depends on runtime) |
--name | — | local runtime name |
--port | 0 | localhost port (default depends on runtime) |
--pull | true | pull the model when the runtime supports it |
--register | false | register the resulting llm service on the current mesh node |
--runtime | vllm-docker | runtime profile: vllm-docker |
--served-model | — | OpenAI-compatible served model name (vLLM) |
--wait | 4m0s | readiness timeout |
falcon agent status
Section titled “falcon agent status”Show local Falcon-managed or attached runtimes
falcon agent statusfalcon agent stop
Section titled “falcon agent stop”Stop a Falcon-managed runtime or detach an external endpoint
falcon agent stop [name]falcon doctor
Section titled “falcon doctor”Diagnose local setup: config, identity, keystore, control plane, node
falcon doctorfalcon endpoint
Section titled “falcon endpoint”OpenAI-compatible endpoint recipes
falcon endpointfalcon endpoint add
Section titled “falcon endpoint add”OpenAI-compatible endpoint recipes
falcon endpoint add [name]falcon gateway
Section titled “falcon gateway”Manage customer-owned gateways
falcon gatewayfalcon gateway deploy
Section titled “falcon gateway deploy”Deploy a customer-owned gateway into your own cloud
falcon gateway deploy [flags]| flag | default | description |
|---|---|---|
--aws | false | deploy into AWS (EC2/VPC) using local aws credentials |
falcon grant
Section titled “falcon grant”Mint a capability token for a private resource (e.g. mcp://local-files)
falcon grant [resource] [flags]| flag | default | description |
|---|---|---|
--action | read | granted action |
--ttl | 10m0s | token lifetime |
falcon join
Section titled “falcon join”Join this machine to a network as a node
falcon join [flags]| flag | default | description |
|---|---|---|
--name | — | node name (default: hostname) |
falcon llm
Section titled “falcon llm”Local LLM runtime recipes
falcon llmfalcon llm init
Section titled “falcon llm init”Local LLM runtime recipes
falcon llm init [name]falcon login
Section titled “falcon login”Authenticate to FalconEyes (org/human identity)
falcon login [flags]| flag | default | description |
|---|---|---|
--control-url | — | control plane URL to set & persist |
--org | dev | organization id (dev mode) |
--token | — | raw Cognito ID token (AWS mode) |
falcon logout
Section titled “falcon logout”Clear the local FalconEyes session
falcon logoutfalcon network
Section titled “falcon network”Manage private overlay networks
falcon networkfalcon network create
Section titled “falcon network create”Create a new private network
falcon network create [name]falcon network list
Section titled “falcon network list”List your networks
falcon network listfalcon nodes
Section titled “falcon nodes”List nodes on the current network
falcon nodesfalcon resolve
Section titled “falcon resolve”Resolve a private service through the gateway using a capability
falcon resolve [service] [flags]| flag | default | description |
|---|---|---|
--action | read | requested action |
--cap | — | capability token from falcon grant |
falcon router
Section titled “falcon router”Model router recipes
falcon routerfalcon router init
Section titled “falcon router init”Model router recipes
falcon router init [name]falcon service
Section titled “falcon service”Register private services on the mesh
falcon servicefalcon service add
Section titled “falcon service add”Register a private service (mcp://… or a2a://…)
falcon service add [uri]falcon status
Section titled “falcon status”Show this node’s mesh status
falcon status