This directory contains the public documentation for hack. Specs remain in SPECS/ (working notes).

• CLI reference
• Architecture
• Sessions - mux session management (tmux or zellij) + API
• Env & secrets - env contract + .hack/.env + OS keychain secrets
• Lifecycle - project startup hooks + managed host processes
• Gateway overview
• Gateway API
• Supervisor
• Extensions
• Control-plane SDK

Monorepo note:

• Root scripts orchestrate workspace tasks through Turbo.
• Package-local commands remain available via bun run --cwd <workspace> <script>.

Quick diagnostics:

• hack usage (resource usage across running projects)
• hack usage --watch (live resource trends)
• hack node routes status (controller-side remote route bridge state)
• hack node routes repair (re-apply persisted remote route bridge routes)

• Start here (first remote node in ~10 minutes):
  • Remote node quickstart
  • Run laptop-to-laptop node pairing e2e
  • Bootstrap a remote node on AWS
  • Bootstrap a remote node on Railway
• Remote setup (one command): hack remote setup
• Initialize a project
• Global settings
• Tickets (git-backed)
• Expose the gateway over SSH
• Expose the gateway with Cloudflare
• Expose the gateway with Tailscale
• Run remote supervisor jobs
• Run a remote node via container image
• Bootstrap a remote node on AWS
• Bootstrap a remote node on Railway
• Bootstrap auth-broker with Neon + Railway
• Create a new extension