HAL 9000

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:

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

Components

Dotfiles

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

CLAUDE.md / AGENTS.md

Dogmatic yet meticulously crafted global instructions for agentic coding:

Also see:

Skills

Agentic skills sharpened by daily use:

  • commit: Splits your changes into atomic conventional commits, hunk by hunk if needed
  • fuck-over-engineering: Ranks what to cut in your codebase, deletes only what you pick
  • best-practices: Searches the web for the recommended way and common gotchas
  • blindspot: Interviews you to turn unknown unknowns into questions you can prompt with
  • simple-english: Rewrites text in Global English: plain words, still native-sounding
  • write-like-me: Drafts or rewrites English prose in my own voice at native fluency
  • audit-claude-settings: Audits your Claude Code settings against the latest docs
  • refactor-claude-md: Refactors a CLAUDE.md so every line earns its always-loaded cost
  • refactor-agents-md: Refactors an AGENTS.md the same way, for Codex
  • refactor-memory: Prunes stale Claude Code auto memory and regroups the MEMORY.md index
  • refactor-skill: Refactors a skill by simplifying it instead of complicating it
/plugin marketplace add vinta/hal-9000
/plugin install hal-skills@hal-9000

If you want to use them in Codex or other coding agents:

npx skills add vinta/hal-9000

Claude Code Plugins

Plugins that wire their own hooks and run themselves:

  • hal-session-auto-rename: Automatically name each session and rename it as the conversation evolves
  • hal-voice: Play HAL 9000 voice clips on Claude Code hook events
/plugin marketplace add vinta/hal-9000
/plugin install hal-session-auto-rename@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 unlink ~/.zshrc                   # Move file back from dotfiles/ and remove the symlink
hal sync                              # Sync all links
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.py
hal sync                              # Update local completion

Demo