npm - slackhive - Versions diffs - 0.2.3 → 0.2.4 - Mend

slackhive 0.2.3 → 0.2.4

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.

Files changed (5) hide show

package/LICENSE +21 -0
package/README.md +71 -32
package/cli/README.md +287 -0
package/{dist → cli/dist}/index.js +1 -1
package/package.json +35 -33

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Pelago Labs
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md CHANGED Viewed

@@ -5,7 +5,7 @@
 # SlackHive
 ### Build your AI-first company on Slack
-#### Deploy and orchestrate Claude Code agents as your teammates
+#### A Karpathy-inspired team of humans and AI specialists, powered by Claude Code
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![npm](https://img.shields.io/npm/v/slackhive?color=cb3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/slackhive)
@@ -24,14 +24,16 @@
 ## Why SlackHive?
-Your Slack workspace is where your team already lives. Every question, decision, and escalation happens there. SlackHive makes that workspace a mix of **people and agents** — side by side, in the same channels, in the same threads.
+Andrej Karpathy made two observations that changed how we think about AI systems: LLMs read **wikis** better than file dumps, and **specialists beat generalists**. SlackHive is what fell out when we took both seriously.
-These aren't chatbots you switch to. They're colleagues you @mention. Each agent connects to the tools your team already uses — Notion, Jira, GitHub, Figma, your database, your analytics stack. **Anyone on the team can create one.** No engineers, no platform team — if you can describe what you need, you can deploy it in minutes.
+One agent per role. Each with its own Karpathy-style wiki, its own tools, its own memory. A Boss agent that delegates instead of cramming everything into one context window. And all of it living in the workspace your team already uses - Slack.
+These aren't chatbots you switch to. They're **colleagues you @mention** - side by side with your people, in the same channels, in the same threads. Each agent connects to the tools your team already uses - Notion, Jira, GitHub, Figma, your database, your analytics stack. **Anyone on the team can create one.** No engineers, no platform team - if you can describe what you need, you can deploy it in minutes.
 ```
 CEO:        @data-analyst revenue is down 8% this week, can you dig in?
 DataBot:    [queries Redshift across 6 dimensions]
-            Found it — enterprise churn spiked Tuesday after the pricing change.
+            Found it - enterprise churn spiked Tuesday after the pricing change.
             3 accounts, $42k ARR at risk.
 Engineer:   @devops the checkout service is throwing 500s
@@ -40,18 +42,18 @@ DevOps:     [reads logs, identifies root cause, opens PR]
 PM:         @designer mock up a simpler onboarding flow
 Designer:   [creates Figma frames via MCP]
-            Done — 3 variants in Figma. Which direction do you want to take?
+            Done - 3 variants in Figma. Which direction do you want to take?
 ```
-Tag a specialist directly when you know who to ask. Or tag `@boss` when you're not sure — Boss finds the right specialist, delegates, and summarizes the result:
+Tag a specialist directly when you know who to ask. Or tag `@boss` when you're not sure - Boss finds the right specialist, delegates, and summarizes the result:
 ```
 You:        @boss can you analyze last week's conversion funnel?
 Boss:       That's right up @data-analyst's alley 👇
-            @data-analyst — conversion funnel analysis for last week.
+            @data-analyst - conversion funnel analysis for last week.
             When you're done, please tag @boss.
-DataBot:    Conversions up 12% WoW, checkout completion jumped 3×. @boss — done!
-Boss:       Conversions are up 12% WoW. The win was checkout — 3× completion rate.
+DataBot:    Conversions up 12% WoW, checkout completion jumped 3×. @boss - done!
+Boss:       Conversions are up 12% WoW. The win was checkout - 3× completion rate.
             Want me to pull a channel or cohort breakdown?
 ```
@@ -63,6 +65,9 @@ Boss:       Conversions are up 12% WoW. The win was checkout — 3× completion
 ```bash
 npm install -g slackhive
+```
+```bash
 slackhive init
 ```
@@ -71,10 +76,24 @@ The CLI will:
 2. Clone the repository
 3. Auto-detect your Claude installation (cross-platform compatible)
 4. Walk you through configuration (API key or subscription, admin credentials)
-5. Build and start the services natively — no Docker required
+5. Build and start the services natively - no Docker required
 Open `http://localhost:3001` and create your first agent.
+#### Hit `EACCES: permission denied` on install?
+If you installed Node from nodejs.org on macOS/Linux, `/usr/local/lib/node_modules` is root-owned and `npm install -g` fails without sudo. Point npm at a user-owned prefix once - no sudo needed again:
+```bash
+mkdir -p ~/.npm-global
+npm config set prefix '~/.npm-global'
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc   # or ~/.bashrc
+source ~/.zshrc
+npm install -g slackhive
+```
+Installing Node via [nvm](https://github.com/nvm-sh/nvm) or Homebrew (`brew install node`) puts it in a user-writable location by default and avoids this entirely. If you'd rather skip global install, `npx slackhive init` works too - just prefix every command with `npx`.
 ### CLI Commands
 | Command | Description |
@@ -104,7 +123,7 @@ ADMIN_USERNAME=admin
 ADMIN_PASSWORD=<strong-random-password>
 AUTH_SECRET=                        # generate: openssl rand -hex 32
 ENV_SECRET_KEY=                     # generate: openssl rand -hex 32
-DATABASE_TYPE=sqlite                # embedded — no external DB needed
+DATABASE_TYPE=sqlite                # embedded - no external DB needed
 ```
 ```bash
@@ -123,18 +142,18 @@ Open `http://localhost:3001`, log in, and create your first agent.
 ## ✨ Features
-### 🤖 Real AI Agents — Not Chatbots
+### 🤖 Real AI Agents - Not Chatbots
-Every agent is a full **Claude Code** agent — with tools, memory, identity, and instructions. When you @mention one in Slack, you're running a real AI agent that can use tools, take action, and get smarter over time.
+Every agent is a full **Claude Code** agent - with tools, memory, identity, and instructions. When you @mention one in Slack, you're running a real AI agent that can use tools, take action, and get smarter over time.
 | | |
 |---|---|
-| 🧠 **Persistent Memory** | Agents write memories during conversations — feedback, user context, project state. Synced to SQLite, injected on next start. They don't forget. |
-| 🔌 **MCP Tool Integration** | Connect any MCP server (Redshift, GitHub, Notion, Figma, custom APIs) — stdio, SSE, or HTTP transports. |
-| 📝 **Inline TypeScript MCPs** | Paste TypeScript source directly into the UI — no deployment needed. The runner compiles and executes it. |
-| 🧵 **Full Thread Context** | Agents fetch the entire Slack thread on every invocation — zero context lost in handoffs. |
+| 🧠 **Persistent Memory** | Agents write memories during conversations - feedback, user context, project state. Synced to SQLite, injected on next start. They don't forget. |
+| 🔌 **MCP Tool Integration** | Connect any MCP server (Redshift, GitHub, Notion, Figma, custom APIs) - stdio, SSE, or HTTP transports. |
+| 📝 **Inline TypeScript MCPs** | Paste TypeScript source directly into the UI - no deployment needed. The runner compiles and executes it. |
+| 🧵 **Full Thread Context** | Agents fetch the entire Slack thread on every invocation - zero context lost in handoffs. |
 | 💾 **Session Continuity** | Slack thread ↔ Claude session mapping survives restarts. Pick up exactly where you left off. |
-| 🔐 **Encrypted Secret Store** | API keys encrypted at rest (AES-256). MCPs reference secrets by name — raw values never touch the API or UI. |
+| 🔐 **Encrypted Secret Store** | API keys encrypted at rest (AES-256). MCPs reference secrets by name - raw values never touch the API or UI. |
 | 🔁 **Hot Reload** | Edit instructions, skills, or tools and the agent picks up changes within seconds. No restart needed. |
 ### 👑 Boss + Specialist Hierarchy
@@ -145,7 +164,7 @@ Every agent is a full **Claude Code** agent — with tools, memory, identity, an
 | 🏢 **Multi-Boss Support** | Run multiple Boss agents for different domains (engineering, data, support). Specialists can report to more than one boss. |
 | 📋 **Auto-Generated Registries** | Every Boss gets a live team roster auto-regenerated whenever the team changes. No manual maintenance. |
 | 🛠 **Skills** | Markdown files deployed as Claude Code slash commands. Give agents SQL rules, writing guidelines, or domain playbooks. |
-| ⏰ **Scheduled Jobs** | Cron-based recurring tasks — daily reports, weekly digests, monitoring alerts — posted to any Slack channel or DM. |
+| ⏰ **Scheduled Jobs** | Cron-based recurring tasks - daily reports, weekly digests, monitoring alerts - posted to any Slack channel or DM. |
 ### ⚙️ Platform
@@ -153,10 +172,12 @@ Every agent is a full **Claude Code** agent — with tools, memory, identity, an
 |---|---|
 | 🧙 **Onboarding Wizard** | 5-step guided setup: identity → Slack app → credentials → tools & skills → review. |
 | 🕓 **Version Control** | Every save auto-snapshots the full agent state. Browse history with line-level diffs, restore any version in one click. |
-| 🔒 **Auth & RBAC** | 4 roles (superadmin / admin / editor / viewer), HMAC-signed sessions, per-agent write access grants. No external auth provider needed. |
+| 🔒 **Auth & RBAC** | 4 roles (superadmin / admin / editor / viewer), HMAC-signed sessions, per-agent access grants (View or Edit). Agents are hidden by default — admins grant access explicitly. No external auth provider needed. |
 | 🚦 **Channel Restrictions** | Lock agents to specific Slack channels. Bot auto-leaves uninvited channels with a notice. |
-| 📊 **Live Logs** | SSE-streamed log output per agent — with level filters and search. |
-| 🧠 **Memory Viewer** | Browse, inspect, and delete agent memories by type — feedback, user, project, reference. |
+| 📊 **Live Logs** | SSE-streamed log output per agent - with level filters and search. |
+| 🧠 **Memory Viewer** | Browse, inspect, and delete agent memories by type - feedback, user, project, reference. |
+| 📡 **Activity Dashboard** | Live kanban of every task your agents are working on - Active, Completed, Errors - with drill-down to every tool call. A superadmin-only **Usage** tab breaks down token consumption per agent and ranks power users by tasks started. Admins see everything; editors see only agents they own or are granted access to; viewers are blocked. |
+| 🌐 **Multi-Workspace** | Connect multiple Slack workspaces to a single SlackHive instance. Each workspace gets its own agents and configurations. |
 ---
@@ -167,7 +188,7 @@ Slack Workspace (@boss, @data-bot, @writer, ...)
         │ Socket Mode (Bolt)
         ▼
 ┌──────────────────────────────────────────────────┐
-│  Local host — two Node.js processes              │
+│  Local host - two Node.js processes              │
 │                                                  │
 │  Web (Next.js :3001) ──HTTP──► Runner (:3002)    │
 │            │                        │            │
@@ -178,9 +199,9 @@ Slack Workspace (@boss, @data-bot, @writer, ...)
 | Service | Description |
 |---------|-------------|
-| **Web** (Next.js 15) | Dashboard — create agents, edit skills, view logs, manage users |
+| **Web** (Next.js 15) | Dashboard - create agents, edit skills, view logs, manage users |
 | **Runner** (Node.js) | Hosts all agent processes and Slack connections |
-| **SQLite** | Embedded — stores agents, memories, skills, sessions, users, history. No external DB to install |
+| **SQLite** | Embedded - stores agents, memories, skills, sessions, users, history. No external DB to install |
 | **Event bus** | Web posts to the runner's internal HTTP port to deliver hot-reload events |
 **How a message flows:**
@@ -196,19 +217,37 @@ Slack Workspace (@boss, @data-bot, @writer, ...)
 ## 🔑 Claude Code Authentication
-Two options — use whichever fits your setup:
+Two options - use whichever fits your setup:
-**Option A — API Key**
+**Option A - API Key**
 ```env
 ANTHROPIC_API_KEY=sk-ant-api03-...
 ```
 Billed per token via the Anthropic API. Best for teams and production.
-**Option B — Claude Pro or Max Subscription**
+**Option B - Claude Pro or Max Subscription**
+First, install Claude Code on your host machine:
+> **Note:** Do not install via `npm` - the npm package is deprecated and incompatible with SlackHive.
+MacOS/Linux (Recommended):
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+```
+Homebrew (macOS/Linux):
+```bash
+brew install --cask claude-code
+```
+For more installation options, uninstall steps, and troubleshooting, see the [setup documentation](https://docs.anthropic.com/en/docs/claude-code/setup).
+Then log in:
 ```bash
 claude login    # saves credentials to your system keychain / ~/.claude/
 ```
-Leave `ANTHROPIC_API_KEY` unset — the runner picks up credentials from the system keychain automatically. Best for individual developers.
+Leave `ANTHROPIC_API_KEY` unset - the runner picks up credentials from the system keychain automatically. Best for individual developers.
 > Full guide → [slackhive.mintlify.app/configuration/env-vars](https://slackhive.mintlify.app/configuration/env-vars)
@@ -228,7 +267,7 @@ Leave `ANTHROPIC_API_KEY` unset — the runner picks up credentials from the sys
 - [ ] Analytics dashboard
 - [ ] Custom tool builder (no MCP server needed)
 - [ ] Agent templates marketplace
-- [ ] RAG integration — connect agents to document stores
+- [ ] RAG integration - connect agents to document stores
 Have an idea? [Open an issue](https://github.com/pelago-labs/slackhive/issues)
@@ -243,7 +282,7 @@ cd slackhive && npm install
 # Configure
 cp .env.example .env    # then fill in ADMIN_PASSWORD, AUTH_SECRET, ENV_SECRET_KEY
-# Run locally (SQLite — no external services required)
+# Run locally (SQLite - no external services required)
 cd apps/web && npm run dev      # http://localhost:3000
 cd apps/runner && npm run dev   # http://localhost:3002
 ```
@@ -274,7 +313,7 @@ Open an issue before submitting large PRs so we can align on the approach.
 ## 🔒 Security
-Use [GitHub's private vulnerability reporting](https://github.com/pelago-labs/slackhive/security/advisories/new) — click **"Report a vulnerability"** on the Security tab. Please don't open public issues for security bugs. We respond within 48 hours.
+Use [GitHub's private vulnerability reporting](https://github.com/pelago-labs/slackhive/security/advisories/new) - click **"Report a vulnerability"** on the Security tab. Please don't open public issues for security bugs. We respond within 48 hours.
 ---

package/cli/README.md ADDED Viewed

@@ -0,0 +1,287 @@
+<div align="center">
+<img src="https://raw.githubusercontent.com/pelago-labs/slackhive/main/apps/web/public/logo.svg" alt="SlackHive" width="80" />
+# SlackHive
+### Build your AI-first company on Slack
+#### Deploy and orchestrate Claude Code agents as your teammates
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/slackhive?color=cb3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/slackhive)
+[![npm downloads](https://img.shields.io/npm/dt/slackhive?color=cb3837&logo=npm&logoColor=white&label=installs)](https://www.npmjs.com/package/slackhive)
+[![Node.js](https://img.shields.io/badge/Node.js-≥20-339933?logo=node.js&logoColor=white)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org)
+[![SQLite](https://img.shields.io/badge/SQLite-embedded-003B57?logo=sqlite&logoColor=white)](https://sqlite.org)
+[![Documentation](https://img.shields.io/badge/docs-slackhive.mintlify.app-D97757?logo=gitbook&logoColor=white)](https://slackhive.mintlify.app)
+[![Security Audit](https://github.com/pelago-labs/slackhive/actions/workflows/audit.yml/badge.svg)](https://github.com/pelago-labs/slackhive/actions/workflows/audit.yml)
+[**Documentation**](https://slackhive.mintlify.app) · [Quick Start](#-quick-start) · [Features](#-features) · [Architecture](#-architecture) · [Contributing](#-contributing)
+</div>
+---
+## Why SlackHive?
+Your Slack workspace is where your team already lives. Every question, decision, and escalation happens there. SlackHive makes that workspace a mix of **people and agents** — side by side, in the same channels, in the same threads.
+These aren't chatbots you switch to. They're colleagues you @mention. Each agent connects to the tools your team already uses — Notion, Jira, GitHub, Figma, your database, your analytics stack. **Anyone on the team can create one.** No engineers, no platform team — if you can describe what you need, you can deploy it in minutes.
+```
+CEO:        @data-analyst revenue is down 8% this week, can you dig in?
+DataBot:    [queries Redshift across 6 dimensions]
+            Found it — enterprise churn spiked Tuesday after the pricing change.
+            3 accounts, $42k ARR at risk.
+Engineer:   @devops the checkout service is throwing 500s
+DevOps:     [reads logs, identifies root cause, opens PR]
+            Memory leak in the payment processor pool. PR #847 is up with the fix.
+PM:         @designer mock up a simpler onboarding flow
+Designer:   [creates Figma frames via MCP]
+            Done — 3 variants in Figma. Which direction do you want to take?
+```
+Tag a specialist directly when you know who to ask. Or tag `@boss` when you're not sure — Boss finds the right specialist, delegates, and summarizes the result:
+```
+You:        @boss can you analyze last week's conversion funnel?
+Boss:       That's right up @data-analyst's alley 👇
+            @data-analyst — conversion funnel analysis for last week.
+            When you're done, please tag @boss.
+DataBot:    Conversions up 12% WoW, checkout completion jumped 3×. @boss — done!
+Boss:       Conversions are up 12% WoW. The win was checkout — 3× completion rate.
+            Want me to pull a channel or cohort breakdown?
+```
+---
+## 🚀 Quick Start
+### Option A: One-command install (recommended)
+```bash
+npm install -g slackhive
+slackhive init
+```
+The CLI will:
+1. Check prerequisites (Git, Node.js ≥ 20, Claude Code)
+2. Clone the repository
+3. Auto-detect your Claude installation (cross-platform compatible)
+4. Walk you through configuration (API key or subscription, admin credentials)
+5. Build and start the services natively — no Docker required
+Open `http://localhost:3001` and create your first agent.
+### CLI Commands
+| Command | Description |
+|---------|-------------|
+| `slackhive init` | Clone, configure, and start SlackHive |
+| `slackhive start` | Start all services |
+| `slackhive stop` | Stop all services (and any orphaned runner processes) |
+| `slackhive status` | Show running services + ports |
+| `slackhive logs` | Tail runner logs |
+| `slackhive update` | Pull latest changes and rebuild |
+### Option B: Manual setup
+**Prerequisites:** Node.js ≥ 20, Git, [Claude Code](https://docs.anthropic.com/en/docs/claude-code/setup) on your PATH
+```bash
+git clone https://github.com/pelago-labs/slackhive.git
+cd slackhive
+cp .env.example .env
+```
+Edit `.env` with your credentials:
+```env
+ANTHROPIC_API_KEY=sk-ant-...        # or use Claude Pro/Max subscription
+ADMIN_USERNAME=admin
+ADMIN_PASSWORD=<strong-random-password>
+AUTH_SECRET=                        # generate: openssl rand -hex 32
+ENV_SECRET_KEY=                     # generate: openssl rand -hex 32
+DATABASE_TYPE=sqlite                # embedded — no external DB needed
+```
+```bash
+npm install
+npm run build
+# Start the stack (web on :3001, runner on :3002)
+npx slackhive start
+```
+Open `http://localhost:3001`, log in, and create your first agent.
+> Full setup guide → [slackhive.mintlify.app/quickstart](https://slackhive.mintlify.app/quickstart)
+---
+## ✨ Features
+### 🤖 Real AI Agents — Not Chatbots
+Every agent is a full **Claude Code** agent — with tools, memory, identity, and instructions. When you @mention one in Slack, you're running a real AI agent that can use tools, take action, and get smarter over time.
+| | |
+|---|---|
+| 🧠 **Persistent Memory** | Agents write memories during conversations — feedback, user context, project state. Synced to SQLite, injected on next start. They don't forget. |
+| 🔌 **MCP Tool Integration** | Connect any MCP server (Redshift, GitHub, Notion, Figma, custom APIs) — stdio, SSE, or HTTP transports. |
+| 📝 **Inline TypeScript MCPs** | Paste TypeScript source directly into the UI — no deployment needed. The runner compiles and executes it. |
+| 🧵 **Full Thread Context** | Agents fetch the entire Slack thread on every invocation — zero context lost in handoffs. |
+| 💾 **Session Continuity** | Slack thread ↔ Claude session mapping survives restarts. Pick up exactly where you left off. |
+| 🔐 **Encrypted Secret Store** | API keys encrypted at rest (AES-256). MCPs reference secrets by name — raw values never touch the API or UI. |
+| 🔁 **Hot Reload** | Edit instructions, skills, or tools and the agent picks up changes within seconds. No restart needed. |
+### 👑 Boss + Specialist Hierarchy
+| | |
+|---|---|
+| 👑 **Boss Orchestration** | Boss reads your message, finds the right specialist, delegates by @mention in the same thread, and summarizes the result. |
+| 🏢 **Multi-Boss Support** | Run multiple Boss agents for different domains (engineering, data, support). Specialists can report to more than one boss. |
+| 📋 **Auto-Generated Registries** | Every Boss gets a live team roster auto-regenerated whenever the team changes. No manual maintenance. |
+| 🛠 **Skills** | Markdown files deployed as Claude Code slash commands. Give agents SQL rules, writing guidelines, or domain playbooks. |
+| ⏰ **Scheduled Jobs** | Cron-based recurring tasks — daily reports, weekly digests, monitoring alerts — posted to any Slack channel or DM. |
+### ⚙️ Platform
+| | |
+|---|---|
+| 🧙 **Onboarding Wizard** | 5-step guided setup: identity → Slack app → credentials → tools & skills → review. |
+| 🕓 **Version Control** | Every save auto-snapshots the full agent state. Browse history with line-level diffs, restore any version in one click. |
+| 🔒 **Auth & RBAC** | 4 roles (superadmin / admin / editor / viewer), HMAC-signed sessions, per-agent write access grants. No external auth provider needed. |
+| 🚦 **Channel Restrictions** | Lock agents to specific Slack channels. Bot auto-leaves uninvited channels with a notice. |
+| 📊 **Live Logs** | SSE-streamed log output per agent — with level filters and search. |
+| 🧠 **Memory Viewer** | Browse, inspect, and delete agent memories by type — feedback, user, project, reference. |
+---
+## 🏗 Architecture
+```
+Slack Workspace (@boss, @data-bot, @writer, ...)
+        │ Socket Mode (Bolt)
+        ▼
+┌──────────────────────────────────────────────────┐
+│  Local host — two Node.js processes              │
+│                                                  │
+│  Web (Next.js :3001) ──HTTP──► Runner (:3002)    │
+│            │                        │            │
+│            └───── SQLite file ──────┘            │
+│                   (./data/slackhive.db)          │
+└──────────────────────────────────────────────────┘
+```
+| Service | Description |
+|---------|-------------|
+| **Web** (Next.js 15) | Dashboard — create agents, edit skills, view logs, manage users |
+| **Runner** (Node.js) | Hosts all agent processes and Slack connections |
+| **SQLite** | Embedded — stores agents, memories, skills, sessions, users, history. No external DB to install |
+| **Event bus** | Web posts to the runner's internal HTTP port to deliver hot-reload events |
+**How a message flows:**
+1. User @mentions an agent in Slack
+2. Runner receives the event via Bolt Socket Mode
+3. Claude Code processes the message with the agent's compiled `CLAUDE.md`
+4. Agent uses MCP tools if needed (Redshift, GitHub, Notion, etc.)
+5. Response is formatted as Slack Block Kit and posted to the thread
+6. Memory files written during the session are synced to SQLite
+7. Next conversation starts with all accumulated knowledge
+---
+## 🔑 Claude Code Authentication
+Two options — use whichever fits your setup:
+**Option A — API Key**
+```env
+ANTHROPIC_API_KEY=sk-ant-api03-...
+```
+Billed per token via the Anthropic API. Best for teams and production.
+**Option B — Claude Pro or Max Subscription**
+```bash
+claude login    # saves credentials to your system keychain / ~/.claude/
+```
+Leave `ANTHROPIC_API_KEY` unset — the runner picks up credentials from the system keychain automatically. Best for individual developers.
+> Full guide → [slackhive.mintlify.app/configuration/env-vars](https://slackhive.mintlify.app/configuration/env-vars)
+---
+## 🔮 Roadmap
+- [x] Boss orchestration + auto-generated team registries
+- [x] Persistent memory system
+- [x] Scheduled jobs
+- [x] Version control with diff view
+- [x] Encrypted environment variables
+- [x] Channel restrictions
+- [x] Multi-workspace support
+- [ ] Webhook triggers (GitHub, Jira, PagerDuty → agent actions)
+- [ ] Agent-to-agent direct messaging
+- [ ] Analytics dashboard
+- [ ] Custom tool builder (no MCP server needed)
+- [ ] Agent templates marketplace
+- [ ] RAG integration — connect agents to document stores
+Have an idea? [Open an issue](https://github.com/pelago-labs/slackhive/issues)
+---
+## 🤝 Contributing
+```bash
+git clone https://github.com/pelago-labs/slackhive.git
+cd slackhive && npm install
+# Configure
+cp .env.example .env    # then fill in ADMIN_PASSWORD, AUTH_SECRET, ENV_SECRET_KEY
+# Run locally (SQLite — no external services required)
+cd apps/web && npm run dev      # http://localhost:3000
+cd apps/runner && npm run dev   # http://localhost:3002
+```
+Open an issue before submitting large PRs so we can align on the approach.
+---
+## 👥 Contributors
+<a href="https://github.com/pelago-labs/slackhive/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=pelago-labs/slackhive" alt="Contributors" />
+</a>
+---
+## ⭐ Star History
+<a href="https://star-history.com/#pelago-labs/slackhive&Date">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=pelago-labs/slackhive&type=Date&theme=dark" />
+    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=pelago-labs/slackhive&type=Date" />
+    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=pelago-labs/slackhive&type=Date" width="600" />
+  </picture>
+</a>
+---
+## 🔒 Security
+Use [GitHub's private vulnerability reporting](https://github.com/pelago-labs/slackhive/security/advisories/new) — click **"Report a vulnerability"** on the Security tab. Please don't open public issues for security bugs. We respond within 48 hours.
+---
+## 📄 License
+MIT © 2026 [Pelago Labs](https://github.com/pelago-labs)
+<div align="center">
+  <sub>Built with Claude Code, Slack Bolt, and a lot of ☕</sub>
+</div>

package/{dist → cli/dist}/index.js RENAMED Viewed

@@ -15578,7 +15578,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "slackhive",
-      version: "0.2.3",
+      version: "0.2.4",
       description: "CLI to install and manage SlackHive \u2014 AI agent teams on Slack",
       bin: {
         slackhive: "./dist/index.js"

package/package.json CHANGED Viewed

@@ -1,45 +1,47 @@
 {
   "name": "slackhive",
-  "version": "0.2.3",
-  "description": "CLI to install and manage SlackHive — AI agent teams on Slack",
+  "version": "0.2.4",
+  "private": false,
+  "description": "Open-source platform for managing teams of Claude Code Slack agents with a boss agent orchestrator",
+  "workspaces": [
+    "apps/*",
+    "packages/*",
+    "cli"
+  ],
   "bin": {
-    "slackhive": "./dist/index.js"
+    "slackhive": "cli/dist/index.js"
   },
   "scripts": {
-    "build": "esbuild src/index.ts --bundle --platform=node --outfile=dist/index.js",
-    "dev": "ts-node src/index.ts"
+    "dev": "sh scripts/dev.sh",
+    "build": "npm run build -w packages/shared && npm run build --workspaces --if-present",
+    "prepare": "npm run build -w cli"
   },
-  "keywords": [
-    "slack",
-    "ai",
-    "agents",
-    "claude",
-    "claude-code",
-    "slackhive"
+  "files": [
+    "cli/dist",
+    "README.md"
   ],
-  "author": "Aman Srivastava",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/pelago-labs/slackhive"
+  "engines": {
+    "node": ">=20.0.0"
   },
+  "license": "MIT",
   "dependencies": {
-    "chalk": "^4.1.2",
-    "commander": "^12.0.0",
-    "ora": "^5.4.1",
-    "prompts": "^2.4.2"
+    "@anthropic-ai/claude-agent-sdk": "^0.2.118",
+    "@anthropic-ai/claude-code": "^2.1.118",
+    "@elastic/elasticsearch": "^9.3.4",
+    "@mozilla/readability": "^0.6.0",
+    "linkedom": "^0.18.12",
+    "pg": "^8.20.0",
+    "turndown": "^7.2.4"
   },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/prompts": "^2.4.9",
-    "esbuild": "^0.28.0",
-    "typescript": "^5.3.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
+  "overrides": {
+    "dompurify": "^3.4.0",
+    "vite": "^6.4.2",
+    "axios": "^1.15.0",
+    "hono": "^4.12.14",
+    "@hono/node-server": "^1.19.13",
+    "follow-redirects": "^1.15.12"
   },
-  "files": [
-    "dist",
-    "README.md"
-  ]
+  "devDependencies": {
+    "@types/turndown": "^5.0.6"
+  }
 }