Quick Start

Quick Start

1. Initialize PurrCode

purrcode init

Initialization:

• discovers supported local providers;
• creates secure local configuration;
• initializes persistence;
• creates a managed workspace;
• starts the authenticated loopback daemon;
• verifies daemon readiness;
• reports sandbox capability.

2. Open a repository

cd path/to/your-project

3. Start the terminal Workbench — or the native IDE

purrcode          # terminal Workbench (default on every platform)
purrcode ide      # native desktop IDE (same as purrcode gui)

4. Connect a model

Inside the TUI or IDE:

/connect

Or import a provider configuration example:

/connect import

Credentials are stored in the operating-system credential store and never enter the model context or tool processes.

5. Submit a task

Examples:

Explain the architecture of this repository.

Add pagination to the orders API and update the tests.

Review the current diff and identify possible regressions.

The composer supports multiline text, source code, logs, JSON, YAML, TOML, and pasted scripts.

Composer shortcuts

Enter          Insert newline
Ctrl+G         Submit
Ctrl+C         Cancel active work

TUI shortcuts

Ctrl+B         Toggle workspace panel
Ctrl+D         Open diff
Ctrl+P         Open command palette
Ctrl+K         Switch task mode
Space or E     Expand selected timeline card
Mouse click    Expand a timeline detail card
Up/Down        Scroll the timeline
Mouse wheel    Scroll the timeline
?              Open help
Ctrl+C         Cancel active work

Typical workflow

Describe task
  ↓
Review plan
  ↓
Inspect retrieved context
  ↓
Approve or reject proposed actions
  ↓
Review execution output
  ↓
Inspect diff
  ↓
Review validation evidence
  ↓
Apply, commit, export, or rollback

For the full command and slash-command list, see CLI Reference.