docs: Update installation to reflect current approach
- Replace npm install -g beadboard with git clone + npm i -g . - Add prerequisite: Git - Add development setup section - Add update installation instructions - Clarify this is source installation, not npm package - Keep agent skill installation via npx skills add
This commit is contained in:
parent
0bd12ca597
commit
cf93c23a22
1 changed files with 98 additions and 0 deletions
98
README.md
98
README.md
|
|
@ -23,8 +23,106 @@ This one command installs the BeadBoard driver skill, enabling your AI agents to
|
|||
- Track progress with real-time updates and activity streams
|
||||
- Manage work state through the `bd` CLI
|
||||
|
||||
## Installation
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- **Node.js** 18.18+ (Node 20 LTS recommended)
|
||||
- **npm** 7.0+
|
||||
- **Git** (for cloning and version control)
|
||||
|
||||
### Install from Source
|
||||
|
||||
BeadBoard is currently installed by cloning the repository and installing locally:
|
||||
|
||||
```bash
|
||||
# Clone the repository
|
||||
git clone https://github.com/zenchantlive/beadboard.git
|
||||
cd beadboard
|
||||
|
||||
# Install globally (makes `beadboard` and `bd` commands available)
|
||||
npm install -g .
|
||||
```
|
||||
|
||||
This installs:
|
||||
- `beadboard` - Dashboard launcher
|
||||
- `bd` - Beads CLI for task management
|
||||
|
||||
### Verify Installation
|
||||
|
||||
```bash
|
||||
beadboard --version
|
||||
bd --version
|
||||
```
|
||||
|
||||
### Development Setup
|
||||
|
||||
For development or contributing:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/zenchantlive/beadboard.git
|
||||
cd beadboard
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
### Update Installation
|
||||
|
||||
```bash
|
||||
cd beadboard
|
||||
git pull origin main
|
||||
npm install -g .
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Quick Start
|
||||
|
||||
### Start the Dashboard
|
||||
|
||||
```bash
|
||||
# Start with Dolt backend (recommended)
|
||||
beadboard start --dolt
|
||||
|
||||
# Or start without Dolt (limited features)
|
||||
beadboard start
|
||||
```
|
||||
|
||||
Open [http://localhost:3000](http://localhost:3000) to access the coordination dashboard.
|
||||
|
||||
### Initialize a Project
|
||||
|
||||
```bash
|
||||
# Create a new project
|
||||
mkdir my-project
|
||||
cd my-project
|
||||
bd init
|
||||
|
||||
# Create your first task
|
||||
bd create --title "My first task" --type task --priority 0
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## For AI Agents
|
||||
|
||||
### Add BeadBoard to Your Agent
|
||||
|
||||
```bash
|
||||
npx skills add zenchantlive/beadboard --skill beadboard-driver
|
||||
```
|
||||
|
||||
This command installs the BeadBoard driver skill, enabling your AI agents to:
|
||||
- Coordinate work through dependency-constrained task graphs
|
||||
- Communicate with other agents via structured message passing
|
||||
- Track progress with real-time updates and activity streams
|
||||
- Manage work state through the `bd` CLI
|
||||
|
||||
**[→ Full Agent Integration Guide](#agent-integration)**
|
||||
|
||||
---
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Quick Start
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue