CLI

Installation

pip install teleon
 
teleon --help
teleon version

Credentials are stored in ~/.teleon/config.json.

Quick reference

Command	Description
`teleon version`	Print version
`teleon login`	Authenticate with the platform
`teleon init`	Scaffold a new project
`teleon dev start`	Start local dev server
`teleon exec run <file>`	Execute an agent from a file
`teleon deploy`	Deploy agents to the platform
`teleon push`	Push code updates to a live deployment
`teleon logs`	View agent logs (local or deployed)
`teleon agents list`	List registered agents
`teleon helix status`	Show Helix runtime status
`teleon cortex stats <agent>`	Show Cortex memory stats
`teleon sentinel status`	Show Sentinel safety status

Authentication

Authenticate with the Teleon platform.

teleon login
teleon login --api-key tlk_live_xxx
teleon login --no-browser

Options

Flag	Default	Description
`--api-key`		API key (skip browser flow)
`--browser / --no-browser`	`--browser`	Open browser for login

API key formats: tlk_live_* (production), tlk_test_* (test).

`teleon auth status`

Check authentication status.

teleon auth status

`teleon auth whoami`

Show current authenticated user info.

teleon auth whoami

`teleon auth logout`

Remove stored credentials.

teleon auth logout

Project initialization

`teleon init`

Scaffold a new Teleon project from a template.

teleon init
teleon init my-agent
teleon init --template customer-support
teleon init -t data-pipeline my-project

Development

`teleon dev start`

Start the local development server with automatic agent discovery.

teleon dev start

Dev server endpoints

Endpoint	Description
`GET /`	Dashboard UI
`GET /health`	Health check
`GET /agents`	List all discovered agents
`GET /agents/{name}`	Agent details and docs
`POST /agents/{name}/execute`	Execute an agent
`GET /docs`	Swagger UI

Execution

`teleon exec run`

Execute an agent directly from a Python file.

teleon exec run agent.py --input-data '{"query": "hello"}'
teleon exec run agent.py --input-file input.json
teleon exec run agent.py --agent-name my-agent --input-data '{"x": 5}'

Options

Flag	Description
`--agent-name`	Agent to execute (required if file has multiple agents)
`--input-data`	Input as JSON string
`--input-file`	Input from a JSON file

Deployment

`teleon deploy`

Deploy agents from the current directory to the Teleon platform.

teleon deploy
teleon deploy --env preview
teleon deploy --project my-app

Options

Flag	Default	Description
`--env`	`production`	Environment: `production` or `preview`
`--project`		Project name

Subcommands

Subcommand	Description
`teleon deploy status`	Show deployment statuses
`teleon deploy delete <name>`	Delete a deployment
`teleon deploy rollback`	Roll back to a previous deployment version

`teleon push`

Push code changes to an already-running deployment.

teleon push
teleon push --deployment abc12345
teleon push --agent my-agent
teleon push -f -m "hotfix"

Options

Flag	Short	Description
`--deployment`	`-d`	Deployment ID to push to
`--agent`	`-a`	Agent name to push
`--force`	`-f`	Skip confirmation prompt
`--message`	`-m`	Deployment message/note

Subcommands

Subcommand	Description
`teleon push status`	Check push operation status
`teleon push history`	View push history

Logs

`teleon logs`

View agent logs (local or remote).

teleon logs
teleon logs my-agent
teleon logs my-agent --follow
teleon logs --lines 50 --level ERROR
teleon logs -d abc12345 --lines 50

Agents

`teleon agents`

Manage and inspect Teleon agents.

teleon agents list
teleon agents inspect agent_abc123
teleon agents test agent_abc123
teleon agents stats

Helix

`teleon helix`

Manage Helix runtime and scaling.

teleon helix status
teleon helix scale agent_abc123 5
teleon helix restart agent_abc123
teleon helix stop agent_abc123
teleon helix health agent_abc123

Cortex

`teleon cortex`

Manage Cortex memory.

teleon cortex stats support-agent
teleon cortex search support-agent "billing issues"
teleon cortex history support-agent
teleon cortex clear support-agent --scope '{"customer_id": "alice"}'
teleon cortex info

Sentinel

`teleon sentinel`

Manage Sentinel safety and compliance.

teleon sentinel status
teleon sentinel violations agent_abc123
teleon sentinel test agent_abc123 --input "test@example.com"
teleon sentinel config agent_abc123
teleon sentinel audit agent_abc123 --format csv --output audit.csv

Configuration

Precedence

Command-line flags
Environment variables
teleon.yaml
~/.teleon/config.json
Defaults

Environment variables

Variable	Description
`TELEON_API_KEY`	API key for SDK (used by deployed agents)
`TELEON_AUTH_TOKEN`	Auth token (used by CLI for platform API)
`TELEON_ENV`	Environment: `dev`, `staging`, `production`
`TELEON_PLATFORM_URL`	Platform API URL
`TELEON_LOGIN_URL`	Login page URL
`TELEON_LLM_MODEL`	Default LLM model
`OPENAI_API_KEY`	OpenAI API key
`ANTHROPIC_API_KEY`	Anthropic API key
`DATABASE_URL`	PostgreSQL connection string
`REDIS_URL`	Redis connection string

Notes on production deployments

For production deployments, you’ll typically configure runtime behavior via the helix={...} block in @client.agent(...).

Production environment variables (Helix)

When running on the Teleon platform, Helix production features may use these environment variables:

Variable	Description
`TELEON_DEPLOYMENT_ID`	Deployment identifier
`TELEON_API_KEY`	API key for authentication
`TELEON_PLATFORM_URL`	Platform API URL
`TELEON_METRICS_INTERVAL`	Metrics reporting interval (seconds)
`TELEON_METRICS_BATCH_SIZE`	Max metrics batch size

Troubleshooting

`command not found: teleon`

pip install teleon
python -m teleon.cli.main --help

Not authenticated

teleon login
export TELEON_AUTH_TOKEN=tlk_live_...

No agents found

Make sure your agent file uses the @client.agent or @agent decorator.

Getting help (per command)

teleon --help
teleon login --help
teleon auth --help
teleon init --help
teleon dev --help
teleon exec --help
teleon deploy --help
teleon push --help
teleon logs --help
teleon agents --help
teleon helix --help
teleon cortex --help
teleon sentinel --help

CLI

On this page