A login shell that launches AI coding tools.
Open a terminal. Land in Claude Code. Or Codex. Or Gemini. Or Aider.
Your shell, your choice.

---

Install

macOS / Linux / WSL:

curl -fsSL https://clawdshell.sh | sh

Windows (PowerShell):

irm https://clawdshell.sh | iex

Windows (CMD):

curl -fsSL https://clawdshell.sh/install.cmd -o install.cmd && install.cmd && del install.cmd

Or grab a binary from Releases and run clawdshell --install.

How it works

Terminal opens
  → ClawdShell launches your AI tool (claude, codex, gemini, ...)
  → When the tool exits, you drop to your regular shell
  → When that shell exits, the terminal closes

Zero friction. Zero delay. Your AI tool is always one terminal-open away.

Your companion

Every installation hatches a unique ASCII companion from an egg.

  ╭─────────────────────────╮
  │   /\_/\       Mochi     │
  │  ( ·   ·)      ★★★     │
  │  (  ω  )       rare     │
  │  (")_(")                │
  ├─────────────────────────┤
  │ DEBUGGING  ████░ 8      │
  │ PATIENCE   ██░░░ 4      │
  │ CHAOS      █████ 10     │
  │ WISDOM     ███░░ 6      │
  │ SNARK      ████░ 7      │
  ╰─────────────────────────╯

See yours with clawdshell --companion. Reroll during setup if you want a different one.

Configuration

Config lives at ~/.config/clawdshell/config.toml:

[defaults]
tool = "claude"              # which tool to launch
fallback_shell = "/bin/zsh"  # shell to drop to after tool exits

[companion]
enabled = true
seed = "a7f2b3"             # determines your companion

[tools.claude]
args = ["--model", "opus"]

[tools.codex]
args = ["--full-auto"]

[tools.gemini]
command = "/usr/local/bin/gemini-cli"

Supported tools

Tool	Binary	Website
Claude Code	claude	claude.ai/code
Codex CLI	codex	openai.com
Gemini CLI	gemini	cloud.google.com
OpenCode	opencode	opencode.ai
Aider	aider	aider.chat
ForgeCode	forge	forgecode.dev

Any binary works — just add a [tools.<name>] section to your config.

Commands

clawdshell                     # launch (normal startup)
clawdshell --install           # setup wizard
clawdshell --uninstall         # restore previous shell
clawdshell --set-tool <name>   # switch default tool
clawdshell --companion         # show your companion
clawdshell -- --resume         # pass args to the tool
clawdshell -c "command"        # run command via fallback shell (ssh/scp compat)

Uninstall

clawdshell --uninstall

Restores your previous shell. Config file is preserved.

License

MIT

---

_{Built with Rust. Powered by your favorite AI.}