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

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

​
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

Cron Jobs

Schedule recurring prompts

Possession Mode

Let Claude control your machine