██╗██████╗  ██████╗
   ██╔╝██╔══██╗██╔═══██╗
  ██╔╝ ██║  ██║██║   ██║
 ██╔╝  ██║  ██║██║   ██║
██╔╝   ██████╔╝╚██████╔╝
╚═╝    ╚═════╝  ╚═════╝

Philosophy

slashdo commands emphasize high-quality software engineering over token conservation. While efforts are made to use agents, models, and prompts efficiently, these tools work hard to ensure your software meets high-quality standards — and will use the tokens necessary to meet that end. Expect thorough reviews, multi-agent scans, and verification loops rather than shortcuts.

Quick Start

With npm/npx:

npx slash-do@latest

Without npm (curl):

curl -fsSL https://raw.githubusercontent.com/atomantic/slashdo/main/install.sh | bash

That's it. slashdo detects your installed AI coding environments and installs commands to each one.

Commands

All commands live under the do: namespace:

| Command | What it does | |:---|:---| | /do:push | Commit and push all work with changelog | | /do:pr | Open a PR with self-review and Copilot review loop | | /do:fpr | Fork PR -- push to fork, PR against upstream | | /do:rpr | Resolve PR review feedback with parallel agents | | /do:release | Create a release PR with version bump and changelog | | /do:review | Deep code review against best practices | | /do:better | Full DevSecOps audit with 7-agent scan and remediation | | /do:goals | Generate GOALS.md from codebase analysis | | /do:replan | Review and clean up PLAN.md | | /do:omd | Audit and optimize markdown files | | /do:update | Update slashdo to latest version | | /do:help | List all available commands |

Supported Environments

  Claude Code   ~/.claude/commands/do/        YAML frontmatter + subdirectories
  OpenCode      ~/.config/opencode/commands/  YAML frontmatter + flat naming
  Gemini CLI    ~/.gemini/commands/do/         TOML headers + subdirectories
  Codex         ~/.codex/skills/              SKILL.md per-command directories

slashdo auto-detects which environments you have installed. Or specify manually:

npx slash-do@latest --env claude             # just Claude Code
npx slash-do@latest --env opencode,gemini    # multiple environments

Install Options

npx slash-do@latest                          # auto-detect + install all
npx slash-do@latest --env claude             # target specific environment
npx slash-do@latest --list                   # show commands and install status
npx slash-do@latest --dry-run                # preview changes
npx slash-do@latest --uninstall              # remove installed commands
curl -fsSL https://raw.githubusercontent.com/atomantic/slashdo/main/uninstall.sh | bash  # curl uninstall
npx slash-do@latest push pr release           # install specific commands only

How It Works

  Source (commands/do/*.md)
       |
       v
  +------------------+
  |   Transformer    |  Converts format per environment:
  |                  |  - YAML frontmatter (Claude, OpenCode)
  +------------------+  - TOML headers (Gemini)
       |                - SKILL.md with inlined libs (Codex)
       v
  +------------------+
  |    Installer     |  Diff-based: only writes changed files
  |                  |  Tracks version for update notifications
  +------------------+
       |
       v
  ~/.claude/commands/do/push.md
  ~/.config/opencode/commands/do-push.md
  ~/.gemini/commands/do/push.md
  ~/.codex/skills/do-push/SKILL.md

Updating

npx slash-do@latest        # from your terminal

/do:update                # from inside your AI coding assistant

Contributing

1. Commands live in commands/do/ as Claude Code format .md files (source of truth)
2. Lib files (shared partials) live in lib/
3. The transformer handles format conversion for each environment
4. Test with node bin/cli.js --list and node bin/cli.js --dry-run

License

MIT