Skip to main content

​
Chucky CLI

The Chucky CLI (@chucky.cloud/cli) is a powerful command-line tool for developers to:
  • Deploy workspaces to Chucky cloud
  • Schedule cron jobs for recurring prompts
  • Run prompts against any project in your account
  • Enable Claude to control your machine with host tools (Possession Mode)

​
Installation

npm install -g @chucky.cloud/cli

​
Authentication

Before using the CLI, authenticate with your Chucky account: 
chucky login
You’ll be prompted to enter your API key (found in app.chucky.cloud under Account Settings).

​
Commands

​
Core Commands

CommandDescription
chucky loginAuthenticate with your Chucky account
chucky listList all projects in your account
chucky initInitialize a new project in the current directory
chucky deployDeploy workspace and cron jobs to Chucky cloud
chucky keysShow HMAC key for current project
chucky promptSend prompts to any project
chucky config anthropicSet Anthropic API key for a project
chucky deleteDelete a project

​
Jobs (Background Tasks)

CommandDescription
chucky jobs createCreate a new background job
chucky jobs listList recent jobs
chucky jobs getGet details of a specific job
chucky jobs cancelCancel a running job

​
Sessions & History

CommandDescription
chucky sessionsList session history

​
Git Bundles (Sync Changes)

CommandDescription
chucky fetchDownload changes to a local branch
chucky diffView pending changes
chucky logView commit history
chucky applyApply changes to working directory
chucky discardRemove fetched branch
chucky pullFetch + apply in one step

​
Quick Examples

​
List your projects

chucky list

​
Send a simple prompt

chucky prompt "What is 2+2?" --project my-project

​
Enable Claude to run commands on your machine

chucky prompt "List all TypeScript files and count them" \
  --project my-project \
  --allow-possession \
  --dangerously-skip-permissions
The --allow-possession flag is a powerful feature that lets Claude execute commands on your local machine. See Possession Mode for details.

​
Next Steps

Prompt Command

All options for the prompt command

Jobs

Create background tasks

Git Bundles

Fetch and apply changes

Sessions

View session history

Cron Jobs

Schedule recurring prompts

Possession Mode

Let Claude control your machine