CLI Usage

The codrsync CLI lets you launch and manage workspaces from your terminal.

Installation

Choose your preferred method:

bash
# Using curl (Linux/macOS)
curl -fsSL https://codrsync.dev/install.sh | bash

# Using npm
npm install -g codrsync

# Using pip
pip install codrsync

# Using Homebrew
brew install codrsync

Authentication

After installing, authenticate with your codrsync account:

bash
codrsync auth login

This opens a browser window for OAuth sign-in. After authenticating, a device token is stored locally for future CLI sessions.

To check your auth status:

bash
codrsync auth status

Starting a Workspace

Launch a new workspace:

bash
# Basic workspace
codrsync start

# With a project URL
codrsync start --project https://github.com/user/repo

# With a template
codrsync start --template fastapi-backend

# In Portuguese
codrsync start --language pt-br

BYOK Mode (Bring Your Own Key)

If you have your own Anthropic API key, you can use BYOK mode for unlimited sessions:

bash
codrsync start --byok --api-key sk-ant-...

In BYOK mode:

• No session time limits
• You pay Anthropic directly for API usage
• All other workspace features work the same

Managing Workspaces

bash
# List your workspaces
codrsync list

# Pause a running workspace
codrsync pause <slug>

# Resume a paused workspace
codrsync resume <slug>

# Delete a workspace
codrsync delete <slug>

Init Mode

The init mode helps you set up Context Engineering for an existing project:

bash
# Run from inside your project directory
codrsync init

This launches an interactive session where Claude analyzes your project and creates:

• CLAUDE.md — AI instructions tailored to your codebase
• doc/project/manifest.json — project metadata
• doc/prps/PRP-001-*.md — initial planning documents

Environment Variables

Troubleshooting

"Authentication required" — Run codrsync auth login to refresh your token.

"Server at capacity" — All workspace slots are in use. Wait a few minutes or try again later.

"Trial cooldown" — Free users get one trial per 30 days. Subscribe to Pro for unlimited sessions.