Pr/v2

.gitignore

@@ -20,4 +20,4 @@ pkg/cli/webapp/*.tsbuildinfo
 !pkg/cli/webapp/dist/
 !pkg/cli/webapp/dist/**
 .grite/
-pkg/cli/webapp/dist/
+hack/

Procfile

@@ -0,0 +1 @@
+dev: go run ./cmd/captain serve --dev

README.md

@@ -134,6 +134,7 @@ The container workflow is designed to package things like:
 ```text
 captain/
 ├── cmd/captain/           # CLI entrypoint
+├── docs/                  # Astro documentation site
 ├── pkg/ai/                # AI abstraction, provider config, models
 ├── pkg/ai/agent/          # Iterative agent loop, plugins (verify, worktree, judge)
 ├── pkg/ai/fixture/        # YAML fixture runner for Claude configuration benchmarks
@@ -468,9 +469,12 @@ Interactive wizard that writes `~/.captain.yaml` with defaults for backend, mode
 captain serve
 captain serve --port 8080
 captain serve --dev
+go run ./cmd/captain serve --dev --open
+task www:dev
+task www:build
 ```
 
-Starts an HTTP API and embedded web UI. The UI launches `captain ai agent` operations and opens follow-up chat windows that resume the returned session. `--dev` starts the Vite dev server from `pkg/cli/webapp` and proxies `/api` back to the Go process.
+Starts an HTTP API and embedded web UI. The UI launches `captain ai agent` operations and opens follow-up chat windows that resume the returned session. `--dev` starts the Vite dev server from `pkg/cli/webapp` and proxies `/api` back to the Go process. Use `task www:dev` for the local Go-backed Vite proxy with the browser opened, and `task www:build` to rebuild the embedded web UI assets.
 
 ### MCP server
 
@@ -508,6 +512,15 @@ Binary output:
 .bin/captain
 ```
 
+### Docs
+
+```bash
+task docs:dev
+task docs:build
+```
+
+The Astro docs site lives in `docs/`. The prompts engine is the first complete section; other Captain areas are scaffolded for future expansion.
+
 ### Test
 
 ```bash

Taskfile.yaml

@@ -16,6 +16,35 @@ tasks:
       - mkdir -p {{.BIN_DIR}}
       - go build -o {{.BIN_DIR}}/{{.BINARY}} ./cmd/captain
 
+  www:build:
+    desc: Build the embedded Captain web UI
+    dir: pkg/cli/webapp
+    cmds:
+      - CI=true pnpm install --frozen-lockfile
+      - pnpm run build
+      - touch dist/.gitkeep
+
+  www:dev:
+    desc: Start Captain with the Vite dev proxy and open the browser
+    dir: pkg/cli/webapp
+    cmds:
+      - CI=true pnpm install --frozen-lockfile
+      - cd ../../.. && go run ./cmd/captain serve --dev --open
+
+  docs:build:
+    desc: Build the Captain Astro documentation site
+    dir: docs
+    cmds:
+      - CI=true pnpm install --frozen-lockfile
+      - pnpm run build
+
+  docs:dev:
+    desc: Start the Captain Astro documentation site
+    dir: docs
+    cmds:
+      - CI=true pnpm install --frozen-lockfile
+      - pnpm run dev
+
   lint:
     desc: Run linters
     cmds:

cmd/captain/main.go

@@ -76,8 +76,9 @@ func main() {
 
 	sessionsCmd := &cobra.Command{Use: "sessions", Short: "Browse Claude and Codex sessions"}
 	rootCmd.AddCommand(sessionsCmd)
-	clicky.AddNamedCommand("list", sessionsCmd, cli.SessionListOptions{}, cli.RunSessionList).Short = "List discovered sessions"
-	clicky.AddNamedCommand("get", sessionsCmd, cli.SessionGetOptions{}, cli.RunSessionGet).Short = "Show a session transcript"
+	clicky.AddNamedCommandWithContext("list", sessionsCmd, cli.SessionListOptions{}, cli.RunSessionList).Short = "List discovered sessions"
+	clicky.AddNamedCommandWithContext("live", sessionsCmd, cli.SessionLiveOptions{}, cli.RunSessionLive).Short = "List sessions with live process health"
+	clicky.AddNamedCommandWithContext("get", sessionsCmd, cli.SessionGetOptions{}, cli.RunSessionGet).Short = "Show a session transcript"
 
 	sandboxCmd := &cobra.Command{
 		Use:   "sandbox",
@@ -169,6 +170,13 @@ func main() {
 	clicky.AddNamedCommand("build", containerCmd, cli.ContainerBuildOptions{}, cli.RunContainerBuild).Short = "Build container image"
 	clicky.AddNamedCommand("run", containerCmd, cli.ContainerRunOptions{}, cli.RunContainerRun).Short = "Run container sandbox"
 
+	cli.RegisterPromptEntity()
+	clicky.GenerateCLI(rootCmd)
+	if err := cli.AttachPromptSchemaFlag(rootCmd); err != nil {
+		fmt.Fprintf(os.Stderr, "failed to attach prompt schema flag: %v\n", err)
+		os.Exit(1)
+	}
+
 	mcpConfig := &mcp.Config{
 		Name:    "captain",
 		Version: version,

docs/.gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+.astro
+

docs/astro.config.mjs

@@ -0,0 +1,15 @@
+import mdx from "@astrojs/mdx";
+import react from "@astrojs/react";
+import tailwindcss from "@tailwindcss/vite";
+import { defineConfig } from "astro/config";
+
+export default defineConfig({
+  integrations: [mdx(), react()],
+  vite: {
+    plugins: [tailwindcss()],
+    resolve: {
+      dedupe: ["react", "react-dom", "@tanstack/react-query"],
+    },
+  },
+});
+

docs/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "captain-docs",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "check": "astro check"
+  },
+  "dependencies": {
+    "@astrojs/mdx": "^7.0.2",
+    "@astrojs/react": "^6.0.1",
+    "@flanksource/clicky-ui": "link:../../clicky-ui/packages/ui",
+    "@flanksource/icons": "^1.0.60",
+    "@mdxeditor/editor": "^4.0.4",
+    "@radix-ui/react-compose-refs": "^1.1.2",
+    "@radix-ui/react-slot": "^1.1.1",
+    "@shikijs/langs": "^1.24.0",
+    "@shikijs/themes": "^1.24.0",
+    "@shikijs/transformers": "^1.24.0",
+    "@tailwindcss/vite": "^4.3.2",
+    "@tanstack/react-query": "^5.90.12",
+    "ai": "^6.0.199",
+    "astro": "^7.0.6",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "dompurify": "^3.4.7",
+    "jotai": "^2.16.0",
+    "marked": "^17.0.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-rnd": "^10.5.3",
+    "recharts": "^3.8.1",
+    "shiki": "^1.24.0",
+    "streamdown": "^2.5.0",
+    "tailwind-merge": "^2.6.0",
+    "tailwindcss": "^4.3.2"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.28",
+    "@types/react-dom": "^18.3.7",
+    "typescript": "~6.0.3"
+  }
+}
+