Skip to main content

CLI for CueAPI - the scheduling API for AI agents

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.4.tar.gz (15.9 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.4-py3-none-any.whl (15.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: cueapi-0.1.4.tar.gz
  • Upload date:
  • Size: 15.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for cueapi-0.1.4.tar.gz
Algorithm Hash digest
SHA256 f059e38290e4ecac3f53a46a93523356125e26a9366e6cf7b533403f483cbfdc
MD5 b3949e86d7bc39a77a4a4991beaedae2
BLAKE2b-256 7e7b4b4c3b0d7cf1571da9f4ad6a0dcf56269103395ed3b2ccebe18a7d79a2a8

See more details on using hashes here.

Provenance

The following attestation bundles were made for cueapi-0.1.4.tar.gz:

Publisher: publish.yml on cueapi/cueapi-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

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

File metadata

  • Download URL: cueapi-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 15.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for cueapi-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 acf2480f3a90239ca8d1f968b7a4594c35c1f2ec4e9866a203d4998615671ea7
MD5 6b9686a9f0714e70efeb3cc564b39bbc
BLAKE2b-256 f8ec2d9671c06da97e2756258c69326a19fb1faf2525fc86f95e4648958ec4d1

See more details on using hashes here.

Provenance

The following attestation bundles were made for cueapi-0.1.4-py3-none-any.whl:

Publisher: publish.yml on cueapi/cueapi-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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