Skip to main content

​
Prerequisites

  • Docker must be installed and running
  • macOS is the primary supported platform; Linux should also work
  • Windows is not currently supported
brew install schmitthub/tap/clawker

​
Install Script

Downloads a pre-built binary from GitHub releases. No Go toolchain required. 
curl -fsSL https://raw.githubusercontent.com/schmitthub/clawker/main/scripts/install.sh | bash

​
Options

Pin a specific version: 
curl -fsSL https://raw.githubusercontent.com/schmitthub/clawker/main/scripts/install.sh | CLAWKER_VERSION=v0.1.3 bash
Install to a custom directory: 
curl -fsSL https://raw.githubusercontent.com/schmitthub/clawker/main/scripts/install.sh | CLAWKER_INSTALL_DIR=$HOME/.local/bin bash

​
Build from Source

Requires Go 1.25+. 
git clone https://github.com/schmitthub/clawker.git
cd clawker && make clawker
export PATH="$PWD/bin:$PATH"

​
Verify Installation

clawker version

​
First-Time Setup

Navigate to a project directory and initialize: 
cd your-project
clawker init
This walks you through a guided setup — pick a language preset (Python, Go, Rust, TypeScript, Java, Ruby, C/C++, C#/.NET, Bare) and Clawker creates a .clawker.yaml config tailored for your stack. User settings and XDG directories are bootstrapped automatically on first run. Clawker stores data following the XDG Base Directory Specification:
DirectoryDefault PathContents
Config~/.config/clawker/settings.yaml, user-level clawker.yaml
Data~/.local/share/clawker/registry.yaml, build cache, worktree directories
State~/.local/state/clawker/Log files, PID files, loop sessions
See the Getting Started guide for the full walkthrough.