@beastmode-develeap/beastmode 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,94 @@
1
+ # BeastMode CLI
2
+
3
+ The command-line interface for BeastMode -- turn natural language intent into verified software.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm install -g @beastmode-develeap/beastmode
9
+ ```
10
+
11
+ Requires Node.js >= 20.
12
+
13
+ ## Quick Start
14
+
15
+ ```bash
16
+ # Initialize a new factory
17
+ beastmode init
18
+
19
+ # Launch the web dashboard
20
+ beastmode board
21
+
22
+ # Check factory status
23
+ beastmode status
24
+
25
+ # Run a single pipeline task
26
+ beastmode run --task "Add user authentication"
27
+
28
+ # Start the daemon (continuous pipeline)
29
+ beastmode daemon
30
+
31
+ # Docker orchestration (image mode)
32
+ beastmode up # Start services (docker compose up)
33
+ beastmode down # Stop services (docker compose down)
34
+ beastmode logs [service] # Stream service logs
35
+ beastmode update [--tag 1.2.3] # Pull latest images and restart
36
+
37
+ # Migrate from daemon config
38
+ beastmode migrate --config config/beastmode.daemon.json
39
+ ```
40
+
41
+ ## Commands
42
+
43
+ | Command | Description |
44
+ |---|---|
45
+ | `beastmode init` | Initialize factory (auto-detects source vs image mode) |
46
+ | `beastmode board` | Launch the web UI (dashboard, kanban, chat) |
47
+ | `beastmode status` | Show factory status overview |
48
+ | `beastmode run --task "..."` | Run a single pipeline task |
49
+ | `beastmode daemon` | Start the daemon (polls for tasks) |
50
+ | `beastmode migrate` | Migrate existing daemon config to factory format |
51
+ | `beastmode mcp` | Start the MCP server (stdio transport) |
52
+ | `beastmode config get <key>` | Read a config value |
53
+ | `beastmode config set <key> <value>` | Set a config value |
54
+ | `beastmode add plugin <source>` | Install a plugin |
55
+ | `beastmode add mcp <name>` | Register an MCP server |
56
+ | `beastmode list` | List extensions (plugins, MCPs, hooks, skills) |
57
+ | `beastmode doctor` | Run diagnostics (includes GHCR auth check) |
58
+ | `beastmode validate` | Validate factory configuration |
59
+ | `beastmode upgrade` | Check for and apply schema upgrades |
60
+ | `beastmode export` | Export factory config |
61
+ | `beastmode import` | Import artifacts (PRD, user stories, etc.) |
62
+ | `beastmode up [--pull]` | Start BeastMode services |
63
+ | `beastmode down [--volumes]` | Stop BeastMode services |
64
+ | `beastmode logs [service]` | Stream service logs (board, ui, daemon) |
65
+ | `beastmode update [--tag ver]` | Pull latest images and restart |
66
+ | `beastmode deploy [--cloud aws]` | Deploy as systemd services or to AWS |
67
+ | `beastmode sync-claude-creds` | Sync Claude Code creds for Docker (macOS) |
68
+ | `beastmode project add <path>` | Register a project repository |
69
+ | `beastmode project list` | List registered projects |
70
+
71
+ ## MCP Integration
72
+
73
+ BeastMode exposes a Model Context Protocol (MCP) server with 14 tools for managing factories, running pipelines, and inspecting results. Any AI assistant with MCP support can use it.
74
+
75
+ ```bash
76
+ # Start the MCP server
77
+ beastmode mcp
78
+
79
+ # Use as an MCP server in Claude Code
80
+ claude --mcp "beastmode:beastmode mcp"
81
+ ```
82
+
83
+ ## Chat UI
84
+
85
+ The board web UI includes a chat page (`#/chat`) that spawns a Claude Code subprocess with the BeastMode MCP server. Talk to your factory using natural language -- create tasks, check status, manage extensions, and run pipelines.
86
+
87
+ ## Documentation
88
+
89
+ - [Getting Started](docs/getting-started.md) -- step-by-step guide from zero to first pipeline run
90
+ - [Plugin Development](docs/plugin-development.md) -- create custom plugins for BeastMode
91
+
92
+ ## License
93
+
94
+ MIT
@@ -0,0 +1,2 @@
1
+
2
+ export { }