@getmonoceros/workbench
CLI for Monoceros — a workbench for local, reproducible dev containers with AI coding tooling as first-class citizens (Claude Code, Atlassian CLIs, GitHub CLI; more to come).
Requirements
- Docker — reachable as a daemon, not just installed
- Node ≥ 20 (with
npm)
If you don't have one of these, you can't install Monoceros. The
install scripts (install.sh, install.ps1) in the repo root check
this up front and print platform-specific guidance.
Installation
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/getmonoceros/workbench/main/installer/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/getmonoceros/workbench/main/installer/install.ps1 | iex
The script checks Docker + Node, installs the package globally via
npm install -g, and sets up shell completion for your shell.
Getting started
monoceros init hello --with-languages=node --with-features=claude
# Add tokens and settings to ~/.monoceros/monoceros-config.env
monoceros apply hello
monoceros shell hello
Set up tab completion once:
monoceros completion zsh > ~/.oh-my-zsh/completions/_monoceros # zsh
monoceros completion bash > ~/.bash_completion.d/monoceros # bash
Full command reference at getmonoceros.build/docs.
License
Apache-2.0 - see LICENSE.