@sesamespace/hivemind 0.1.0 → 0.2.0

package/README.md

@@ -4,30 +4,45 @@ Cognitive architecture for AI agents with multi-layered memory, context isolatio
 
 ## Quick Start
 
+### One-Command Install (recommended)
+
 ```bash
-git clone https://github.com/baileydavis2026/hivemind.git
-cd hivemind
-./install.sh
+curl -sL api.sesame.space/api/v1/hivemind/install | bash -s -- <your-sesame-api-key>
 ```
 
-The installer will:
-1. Install system dependencies (Node.js, pnpm, Rust, Ollama)
-2. Pull the embedding model (nomic-embed-text)
-3. Build the TypeScript runtime and Rust memory daemon
-4. Ask for your **Sesame API key** and **OpenRouter API key**
-5. Generate a launch script
+This installs all dependencies, configures the agent from Sesame, and starts it.
 
-Then start the agent:
+### Manual Install
 
 ```bash
-./start.sh
+# Install the CLI
+npm install -g @sesamespace/hivemind
+
+# Initialize from your Sesame API key
+hivemind init <your-sesame-api-key>
+
+# Start the agent
+hivemind start --config config/default.toml
+
+# (Optional) Install as a service that survives reboots
+hivemind service install
+```
+
+### Development Install
+
+```bash
+git clone https://github.com/baileydavis2026/hivemind.git
+cd hivemind
+pnpm install
+pnpm build
+cd packages/memory && cargo build --release && cd ../..
 ```
 
 ## What You Need
 
 - **macOS** (Apple Silicon recommended)
 - **Sesame API key** — get one at [sesame.space](https://sesame.space)
-- **OpenRouter API key** — get one at [openrouter.ai](https://openrouter.ai)
+- **OpenRouter API key** — get one at [openrouter.ai](https://openrouter.ai) (or provision via Sesame vault)
 
 ## Architecture
 
@@ -52,35 +67,50 @@ Then start the agent:
 | L3 | Semantic Memory | Promoted knowledge (high-access patterns) |
 | L4 | External Memory | Git, files, APIs (on-demand) |
 
-## Configuration
+## CLI Commands
 
-All config lives in `config/default.toml`. Secrets go in `.env`:
+| Command | Description |
+|---------|-------------|
+| `hivemind init <key>` | Initialize agent from Sesame API key |
+| `hivemind start` | Start the agent |
+| `hivemind service install` | Install as launchd service (auto-start on boot) |
+| `hivemind service status` | Check service status |
+| `hivemind service logs` | View recent logs |
+| `hivemind service uninstall` | Remove launchd services |
+| `hivemind fleet` | Manage worker fleet |
 
-```bash
-SESAME_API_KEY=sk_sesame_...
-LLM_API_KEY=sk-or-v1-...
-AGENT_NAME=YourAgentName
-```
+## Configuration
 
-Environment variables override config file values.
+Config is layered (later overrides earlier):
+
+1. `config/default.toml` — shipped defaults
+2. `config/local.toml` — generated by `hivemind init`
+3. `.env` — secrets (SESAME_API_KEY, LLM_API_KEY, AGENT_NAME)
+4. Environment variables — override everything
 
 ## Team Charter
 
-Agent behavior in group chats is governed by `config/TEAM-CHARTER.md`. Edit it to change how agents interact in shared spaces.
+Agent behavior in group chats is governed by `config/TEAM-CHARTER.md`. Edit it to change how agents interact in shared spaces. Changes take effect on agent restart.
 
 ## Development
 
 ```bash
 pnpm install          # Install deps
 pnpm build            # Build all packages
-pnpm test             # Run tests (49 total)
 
-# Run individual test suites
+# Run tests (49 total)
 npx tsx packages/runtime/src/__tests__/fleet.test.ts
 npx tsx packages/runtime/src/__tests__/integration.test.ts
 npx tsx packages/runtime/src/__tests__/fleet-integration.test.ts
 ```
 
+## Publishing
+
+```bash
+./scripts/build-npm.sh                    # Build flat npm package
+cd dist/npm && npm publish --access public  # Publish to npm
+```
+
 ## License
 
 Private — Big Canyon Farms