Skip to content

cueapi/cueapi-cli

Repository files navigation

For AI agents: This is the CueAPI CLI. Install with pip install cueapi. Authenticate with cueapi login. Create a cue: cueapi create --name "task-name" --cron "0 9 * * *" --url https://your-handler.com. List cues: cueapi list. View a cue and its recent executions: cueapi get <cue-id>. Your API key can also be set via CUEAPI_API_KEY env var. Do not retry on authentication errors.

CueAPI CLI

Your agents are failing silently. CueAPI tells you when and why.

Cron has no concept of success. Cue does.

License Python PyPI Docs

The official CLI for CueAPI. Manage your cues, check executions, and verify outcomes from the terminal.

Built for AI builders running agents in production. Schedule your agent tasks, confirm delivery, and verify outcomes without leaving the terminal.


Install

pip install cueapi

Quick start

# Authenticate
cueapi login

# Create your first cue
cueapi create --name "morning-agent-brief" --cron "0 9 * * *" --url https://your-agent.com/run

# See what is scheduled
cueapi list

# Inspect a cue and its recent executions
cueapi get <cue-id>

Why CueAPI over cron?

Cron fires a job. That is it. No retries. No delivery confirmation. No outcome tracking. No visibility.

Feature Cron CueAPI
Fires on schedule Yes Yes
Confirms delivery No Yes
Tracks outcomes No Yes
Retries on failure No Yes (1, 5, 15 min)
Alerts on failure No Yes
Execution history No Yes

Commands

Command Description
cueapi login Authenticate and store API key
cueapi whoami Show current user and plan
cueapi logout Remove local credentials
cueapi quickstart Guided first-cue setup
cueapi create Create a new cue (supports --worker, --payload, --on-failure)
cueapi list List all cues
cueapi get <id> Get cue details and recent executions
cueapi update <id> Update an existing cue
cueapi pause <id> Pause a cue
cueapi resume <id> Resume a cue
cueapi delete <id> Delete a cue
cueapi usage Show current usage and limits
cueapi key regenerate Regenerate API key
cueapi upgrade Open billing
cueapi manage Open Stripe billing portal

Auth

Credentials stored in ~/.config/cueapi/credentials.json.

Override with env var: export CUEAPI_API_KEY=cue_sk_your_key

Or pass inline: cueapi list --api-key cue_sk_your_key


Transport modes

The CLI works with both webhook and worker cues. For worker cues running without a public URL, install the worker daemon separately:

pip install cueapi-worker

See cueapi-python for the full SDK and worker setup.


Links


Releases

Releases are published to PyPI with PEP 740 attestations via GitHub Actions Trusted Publishing.


License

MIT. See LICENSE.


Built by Vector Apps

About

Official CLI for CueAPI. pip install cueapi.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages