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

Command	Description
`chucky login`	Authenticate with your Chucky account
`chucky list`	List all projects in your account
`chucky init`	Initialize a new project in the current directory
`chucky deploy`	Deploy workspace and cron jobs to Chucky cloud
`chucky keys`	Show HMAC key for current project
`chucky prompt`	Send prompts to any project
`chucky config anthropic`	Set Anthropic API key for a project
`chucky delete`	Delete a project

Jobs (Background Tasks)

Command	Description
`chucky jobs create`	Create a new background job
`chucky jobs list`	List recent jobs
`chucky jobs get`	Get details of a specific job
`chucky jobs cancel`	Cancel a running job

Sessions & History

Command	Description
`chucky sessions`	List session history

Git Bundles (Sync Changes)

Command	Description
`chucky fetch`	Download changes to a local branch
`chucky diff`	View pending changes
`chucky log`	View commit history
`chucky apply`	Apply changes to working directory
`chucky discard`	Remove fetched branch
`chucky pull`	Fetch + 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

Getting Started

Guides

CLI

Use Cases

Advanced

Concepts

Use the command line

Chucky CLI

Installation

Authentication

Commands

Core Commands

Jobs (Background Tasks)

Sessions & History

Git Bundles (Sync Changes)

Quick Examples

List your projects

Send a simple prompt

Enable Claude to run commands on your machine

Next Steps

Prompt Command

Jobs

Git Bundles

Sessions

Cron Jobs

Possession Mode

​Chucky CLI

​Installation

​Authentication

​Commands

​Core Commands

​Jobs (Background Tasks)

​Sessions & History

​Git Bundles (Sync Changes)

​Quick Examples

​List your projects

​Send a simple prompt

​Enable Claude to run commands on your machine

​Next Steps

Prompt Command

Jobs

Git Bundles

Sessions

Cron Jobs

Possession Mode

Chucky CLI

Installation

Authentication

Commands

Core Commands

Jobs (Background Tasks)

Sessions & History

Git Bundles (Sync Changes)

Quick Examples

List your projects

Send a simple prompt

Enable Claude to run commands on your machine

Next Steps