Skip to main content

Official CLI for CueAPI — open-source execution accountability primitive for AI agents. Schedule agent work, require evidence-backed outcomes, and gate execution with write-once verification from your terminal.

Project description

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. Check executions: cueapi executions. 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

# Check execution history
cueapi executions

# See what is scheduled
cueapi list

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
cueapi list List all cues
cueapi get <id> Get cue details
cueapi pause <id> Pause a cue
cueapi resume <id> Resume a cue
cueapi delete <id> Delete a cue
cueapi executions View execution history
cueapi usage Show current usage and limits
cueapi key regenerate Regenerate API key
cueapi upgrade Open billing

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cueapi-0.1.5.tar.gz (16.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cueapi-0.1.5-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

Details for the file cueapi-0.1.5.tar.gz.

File metadata

  • Download URL: cueapi-0.1.5.tar.gz
  • Upload date:
  • Size: 16.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for cueapi-0.1.5.tar.gz
Algorithm Hash digest
SHA256 13480dba71d8d8f43148181d2bca6664eb20b61816182e48d839bbd520e19ee0
MD5 13d703d45a439a9de1454956ccf109de
BLAKE2b-256 c4fd14bfeb9c2a717c24631278404cb919d5d1be54a21f8a6f159b9d58121a99

See more details on using hashes here.

File details

Details for the file cueapi-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: cueapi-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 15.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for cueapi-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 57393cbc67e40eae36b1fb0ce44b7335b888a7772a71170a1657ed77c8d6145f
MD5 fa338d6848f1748426080c75566f0217
BLAKE2b-256 50938dde6597e30d7429896a274b1fb142c93bc087686bd76f69e7a9834e4ae7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page