docs: initialize Docusaurus documentation site

.gitignore

@@ -6,4 +6,5 @@ brainstorm.md
 CLAUDE.md
 hjk
 AGENTS.md
+docs/PLAN.md
 dist

README.md

@@ -1,3 +1,57 @@
 # Headjack
 
-Headjack is a small, opinionated tool for launching CLI-based coding agents.
+![Headjack Banner](docs/static/img/banner.png)
+
+A macOS CLI tool for spawning isolated LLM coding agents in container environments.
+
+## Overview
+
+Headjack gives each AI coding agent its own VM-isolated container with a dedicated git worktree, enabling safe parallel development across multiple branches. Run Claude Code, Gemini CLI, or Codex CLI simultaneously on different features without conflicts.
+
+## Features
+
+- **Isolation** - Each agent runs in its own container with a separate filesystem
+- **Branch-based Workflows** - One instance per git branch with dedicated worktrees
+- **Session Persistence** - Attach and detach from long-running agent sessions
+- **Multi-agent Support** - Claude Code, Gemini CLI, and Codex CLI
+- **Secure Authentication** - Credentials stored in macOS Keychain
+
+## Installation
+
+```bash
+brew install jmgilman/tap/headjack
+```
+
+## Quick Start
+
+```bash
+# Authenticate your agent
+hjk auth claude
+
+# Start an agent on a feature branch
+hjk run feat/auth --agent claude "Implement JWT authentication"
+
+# List running instances
+hjk ps
+
+# Attach to an existing session
+hjk attach feat/auth
+```
+
+## Documentation
+
+Full documentation is available at [headjack.gilman.io](https://headjack.gilman.io).
+
+- [Getting Started Tutorial](https://headjack.gilman.io/tutorials/getting-started) - Installation and first agent
+- [CLI Reference](https://headjack.gilman.io/reference/cli/run) - Complete command documentation
+- [Architecture](https://headjack.gilman.io/explanation/architecture) - How Headjack works
+
+## Requirements
+
+- macOS
+- [Podman](https://podman.io/) (default) or Apple Virtualization
+- Git
+
+## License
+
+[MIT](LICENSE)

docs/.gitignore

@@ -0,0 +1,21 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+PLAN.md
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docs/README.md

@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+## Installation
+
+```bash
+yarn
+```
+
+## Local Development
+
+```bash
+yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+## Build
+
+```bash
+yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+## Deployment
+
+Using SSH:
+
+```bash
+USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```bash
+GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.