HAL 9000

Opinionated AI coding agent and dev environment automation for macOS that dominates your dev setup like cats rule the Internet.

This project is named after Arthur C. Clarke's 2001: A Space Odyssey, a heuristic algorithmic computer designed for sentient processing and total mission control.

Bootstrap

All-in-one command to set up:

• Agent Skills
• Claude Code / Plugins / Rules / Statusline
• Codex
• Python
• Node.js
• Bun
• Solidity
• Docker (OrbStack)
• Kubernetes
• Amazon Web Services
• Google Cloud

curl -sL https://raw.githubusercontent.com/vinta/hal-9000/main/bin/open-the-pod-bay-doors | bash

Components

Dotfiles

Tool configs hardened against supply chain attacks and tuned for better DX:

• .claude/settings.json
• .codex/config.toml
• .config/ghostty/config
• .config/uv/uv.toml
• .npmrc
• .zshrc

CLAUDE.md / AGENTS.md

Opinionated yet meticulously crafted global instructions for agentic coding:

• ~/.claude/CLAUDE.md
• ~/.codex/AGENTS.md

Also see:

• Claude Code: Things I Learned After Using It Every Day

Claude Code Plugin: hal-skills

• commit: Creates clean, atomic git commits with conventional messages
• blindspot: Surveys unfamiliar territory and turns your unknown unknowns into known unknowns
• best-practices: Researches current best practices from docs and the web before you code
• simple-english: Rewrites technical writing in Global English, clear for a global audience
• audit-claude-settings: Audits your Claude Code settings and suggests tailored changes
• refactor-claude-md: Refactors a CLAUDE.md toward progressive disclosure
• refactor-agents-md: Refactors an AGENTS.md toward progressive disclosure

/plugin marketplace add vinta/hal-9000
/plugin install hal-skills@hal-9000

If you want to use them in Codex:

npx skills add vinta/hal-9000

Claude Code Plugin: hal-voice

• hal-voice: Play HAL 9000 voice clips on Claude Code hook events

/plugin marketplace add vinta/hal-9000
/plugin install hal-voice@hal-9000

Claude Code Statusline

• hal-statusline: Show the current model, directory, git branch, and model usage status in statusline
  • Plus a grammar check on every prompt you type, with explanations in Traditional Chinese

curl -sL https://raw.githubusercontent.com/vinta/hal-9000/main/scripts/install-hal-statusline.sh | bash

CLI: hal

hal update                            # Run all Ansible roles to set up the dev environment
hal update --tags python,node         # Run specific Ansible roles
hal link ~/.zshrc                     # Move file into dotfiles/ and symlink it back
hal copy ~/.config/ghostty/config     # Copy file into dotfiles/ (no symlink)
hal sync                              # Sync all links and copies
hal backup                            # Back up live data to Dropbox
hal restore                           # Restore live data from Dropbox (overwrites local)
hal open-the-pod-bay-doors            # Open the pod bay doors, please, HAL

Development

make install                          # Install dev dependencies and pre-commit hooks
make test                             # Run tests
make hal-completion                   # Regenerate zsh completion after modifying bin/hal
hal sync                              # Update local completion

Demo