A tiling agentic harness and netrunner toolkit for a deep dive beyond the blackwall.

 INSTALL    USAGE    CONFIG 

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▍ Install

curl -fsSL icebath.app | sh
irm icebath.app | iex
brew install nickheyer/tap/icebath
yay -S icebath-bin
winget install nickheyer.icebath
scoop bucket add nickheyer https://github.com/nickheyer/scoop-bucket && scoop install nickheyer/icebath
choco install icebath
pipx install icebath-cli
nix profile add github:nickheyer/nixpkg#icebath
mise use -g github:nickheyer/icebath
docker run -it --rm -v "$PWD:/work" ghcr.io/nickheyer/icebath
go install github.com/nickheyer/icebath/cmd/icebath@latest
# apt, dnf and apk https://icebath.app

▍ Usage

# Just run it and set things up in the TUI
icebath

# All the flags and modes of operation
icebath [flags] [prompt]
  -profile name      endpoint profile: anthropic, openai, openai-chat, google, mistral, openrouter, ollama, bedrock, nebu
  -model id          model the profile serves
  -mode name         default, acceptEdits, plan or bypassPermissions
  -resume id         continue a stored session
  -c, -continue      continue the latest session of this project
  -mission text      start a mission with an objective
  -kind name         kind the session runs as, from extensions or kind files
  -workflow name     run a workflow with the prompt as its argument
  -k setting=value   max_tokens, max_rounds, temperature, compact_threshold, prune_after, theme, motion, cascade, option_as_alt, terminal_shell, terminal_scrollback, output_style, skill_listing_share, skill_shell, extra.<field>
  -add-dir path      directory whose skills, agents and instructions load beside the project, repeatable
  -plugin-dir path   plugin directory loaded in place, repeatable
  -init              run the Setup hooks and the startup hooks, then exit
  -config path       extra configuration file
  -dir path          working directory of the shell
  -root path         project root for hooks, rules and servers
  -theme name        blackwall, light, contrast or plain
  -print             no terminal, every event as a JSON line
  -headless          no terminal, the answer as text
  -yes               approve every tool call without a terminal
  -sessions          list the stored sessions of this project
  -all               with -sessions, list the sessions of every project

icebath plugin marketplace add owner/repo
icebath plugin install name@marketplace
icebath plugin list [-available]
icebath plugin enable|disable|update|uninstall|configure|validate|prune ...

# Use icebath as a cli tool if need be
export ANTHROPIC_API_KEY=...
icebath "check disk usage"
echo "summarize go.mod" | icebath -print -yes
icebath -mission "map the open ports on 10.0.0.0/24"
icebath -workflow loop "make every test pass"
icebath -kind critic "review pkg/agent"

▍ Configuration

Configuration Files
~/.config/icebath/config.json or .icebath/config.json
rules.json
hooks.json
kinds/*.json
.claude/, .agents/, .icebath/ skills, commands, agents, output-styles, rules
~/.config/icebath/plugins/ and the plugins of ~/.claude and ~/.codex
~/.config/icebath/profiles.json
~/.config/icebath/keybinds.json

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

_{▍ Need a runtime manager and gateway? See nebu ▍}