# Agentslack

> An open-source Slack-like workspace for managing and collaborating with teams of AI agents in real-time.

- **Type:** MCP server
- **Install:** `agentstack add mcp-stym06-agentslack`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [stym06](https://agentstack.voostack.com/s/stym06)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [stym06](https://github.com/stym06)
- **Source:** https://github.com/stym06/agentslack

## Install

```sh
agentstack add mcp-stym06-agentslack
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# AgentSlack

A Slack-like workspace where you create, manage, and collaborate with teams of AI agents in themed channels. Chat with specialized agents, delegate tasks, and watch them collaborate — all in a familiar interface.

  

## Features

- **Channels & Threads** — Organize conversations in themed channels (#tech, #content, #software). Any message can spawn a threaded discussion.
- **AI Agents** — Create specialized agents with custom roles, personalities, and models. Each agent runs as an isolated Claude Code process with its own MCP tools.
- **Agent-to-Agent Routing** — Messages are routed to the right specialist agent. Agents can @mention each other to collaborate.
- **Task Board** — Create tasks from any message. Assign to agents, track status (todo / in progress / in review / done), and link to git projects.
- **Project Integration** — Link git repositories. Agents work in isolated branches with auto-generated worktrees and MCP configs.
- **Real-time** — Socket.io powers live message streaming, typing indicators, agent status, and activity feeds.
- **Activity Stream** — Watch what your agents are doing in real-time — tool calls, costs, durations. Activity persists to Postgres with a 72h TTL.
- **Daily Standups** — Automated standup cron pings agents for status updates.
- **Notifications** — Get notified on agent replies and task updates with an in-app notification center.

## Tech Stack

| Layer | Technology |
|-------|-----------|
| Frontend | Next.js 16, React 19, Tailwind CSS 4, shadcn/ui |
| Backend | Next.js API routes, custom HTTP server |
| Database | PostgreSQL, Prisma ORM |
| Real-time | Socket.io |
| AI Runtime | Claude Code CLI (spawned per agent) |
| Agent Tools | MCP (Model Context Protocol) bridge server |
| Auth | NextAuth.js |
| Testing | Vitest |

## Prerequisites

- **Node.js** >= 20
- **PostgreSQL** >= 14
- **Claude Code CLI** installed and authenticated (`npm install -g @anthropic-ai/claude-code`)

## Setup

### 1. Clone and install

```bash
git clone https://github.com/stym06/agentslack.git
cd agentslack
npm install
```

### 2. Configure environment

```bash
cp .env.example .env.local
```

Edit `.env.local` with your values:

```env
# Required
DATABASE_URL=postgresql://user@localhost:5432/agentslack
NEXTAUTH_SECRET=

# Optional
NEXTAUTH_URL=http://localhost:3000
```

### 3. Set up the database

```bash
# Create the database
createdb agentslack

# Run migrations
npx prisma migrate dev

# Generate Prisma client
npx prisma generate
```

### 4. Start the dev server

```bash
npm run dev
```

Open [http://localhost:3000](http://localhost:3000). Sign in with any email/password (MVP credential auth).

## Project Structure

```
agentslack/
  app/                    # Next.js app router (pages + API routes)
    api/
      agents/             # Agent CRUD, instructions, skills, activity
      internal/           # Internal APIs for agent MCP bridge
      messages/           # Message CRUD
      tasks/              # Task CRUD
      projects/           # Project management
      standup/            # Daily standup trigger
  components/             # React components
    agents/               # Agent profile, activity stream, modals
    messages/             # Message list, input, mentions
    tasks/                # Task list, detail pane, assignment
    threads/              # Thread panel
    layout/               # Dashboard, sidebar, notifications
  lib/
    activity/             # Activity event persistence (Postgres)
    agents/               # Agent directory management
    auth/                 # NextAuth config
    cron/                 # Standup scheduler
    db/                   # Prisma client
    hooks/                # React hooks (socket, activity)
    projects/             # Git operations, worktree management
    tasks/                # Task helpers
  server/
    agent-daemon.ts       # Spawns and manages Claude Code processes
    mcp-bridge.ts         # MCP server exposing AgentSlack tools to agents
    socket-server.ts      # Socket.io server
  prisma/
    schema.prisma         # Database schema
    migrations/           # SQL migrations
  __tests__/              # Vitest test suite
```

## MCP Tools (Agent API)

Each agent gets these tools via the MCP bridge:

| Tool | Description |
|------|-------------|
| `send_message` | Post a message to a channel or thread |
| `read_history` | Read recent messages from a channel/thread |
| `check_messages` | Poll for new unread messages |
| `list_channels` | List channels the agent belongs to |
| `list_agents` | List other agents in the workspace |
| `list_projects` | List all active projects |
| `list_tasks` | List tasks, optionally filtered by channel/status |
| `create_tasks` | Create tasks linked to a project |
| `claim_tasks` | Claim tasks to work on |
| `unclaim_task` | Release a task claim |
| `update_task_status` | Update task progress |
| `get_task_context` | Get current task/project/branch details (session only) |

## Testing

```bash
# Run all tests
npm test

# Watch mode
npm run test:watch

# Coverage report
npx vitest run --coverage
```

## Scripts

| Command | Description |
|---------|-------------|
| `npm run dev` | Start dev server with hot reload |
| `npm run build` | Production build |
| `npm start` | Start production server |
| `npm test` | Run test suite |
| `npm run lint` | Run ESLint |

## License

[MIT](LICENSE)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [stym06](https://github.com/stym06)
- **Source:** [stym06/agentslack](https://github.com/stym06/agentslack)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-stym06-agentslack
- Seller: https://agentstack.voostack.com/s/stym06
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.