SidStack

AI-Powered Project Intelligence Platform. Structured knowledge, impact analysis, governance, and training for Claude Code.

Local-first. SQLite-based. No external services required.

What It Does

Feature	Description
Knowledge System	Structured project docs (.sidstack/knowledge/) that give every Claude session full context
AI Auto-Bootstrap	init --scan analyzes your codebase and generates knowledge docs automatically
Impact Analysis	Assess scope, risks, and blockers before making changes
Task Management	Track AI work with governance and quality gates
Ticket Queue	Intake external tickets, review, convert to tasks
Training Room	Capture lessons from incidents, build reusable rules

Quick Start

MCP Server (Claude Code)

Initialize your project — this sets up governance, MCP config, and optionally generates knowledge docs with AI:

npx @sidstack/cli init --scan

Or configure MCP manually:

{
  "mcpServers": {
    "sidstack": {
      "command": "npx",
      "args": ["-y", "@sidstack/mcp-server"]
    }
  }
}

Claude Code now has access to MCP tools for knowledge, tasks, impact analysis, tickets, training, memory, and agent desk management.

Desktop App (macOS)

Download the .dmg from Releases.

Or build from source:

git clone https://github.com/junixlabs/sidstack.git
cd sidstack
pnpm install && pnpm packages:build && pnpm tauri:build

See Quick Start Guide for full setup instructions.

MCP Tools

# Knowledge (9) - understand your project
knowledge_search         Semantic search across knowledge and memory (SidMemo)
knowledge_list           List available docs
knowledge_get            Get single document with full content
knowledge_modules        List modules with stats
knowledge_module_overview Get module architecture overview
knowledge_create         Create knowledge document
knowledge_update         Update knowledge document
knowledge_delete         Delete knowledge document
knowledge_health         Check knowledge coverage health

# Tasks (5) - track AI work
task_create              Create task with governance
task_update              Update status/progress
task_list                List tasks with filtering
task_get                 Get task details
task_complete            Complete with quality gate check

# Impact Analysis (3) - assess risk
impact_analyze           Run impact analysis on a change
impact_check_gate        Check gate status (blocked/warning/clear)
impact_list              List analyses

# Tickets (4) - external intake
ticket_create            Create ticket
ticket_list              List/filter tickets
ticket_update            Update status
ticket_convert_to_task   Convert to task

# Training (6) - learn from mistakes
incident_create          Report an incident
incident_list            List incidents
lesson_create            Create lesson from incident
lesson_list              List lessons
rule_check               Check rules for context
training_context_get     Get training context for session

# Test Results (3) - persist test execution
test_result_create       Persist test execution results
test_result_list         List test results with filtering
test_result_get          Get detailed test result

# Agent Desk (4) - workspace isolation
desk_create              Create agent desk (git worktree)
desk_list                List all agent desks
desk_status              Get desk status and current task
desk_remove              Remove agent desk

# Memory (5) - store learnings
memory_add               Store a memory entry
memory_list              List memory entries
memory_delete            Delete a memory entry
memory_index_knowledge   Index knowledge docs into memory
memory_cleanup           Clean up expired entries

# Entity References (3)
entity_link              Link entities (task↔knowledge, etc.)
entity_references        Get references for an entity
entity_context           Build context from linked entities (entity mode + RAG mode)

Desktop App - 7 Views

View	Shortcut	Description
Project Hub	Cmd+1	Capability tree, entity connections, project overview
Task Manager	Cmd+2	List, kanban, timeline, detail views
Knowledge Browser	Cmd+3	Tree view, search, type filtering
Ticket Queue	Cmd+4	Status workflow, convert to tasks
Training Room	Cmd+5	Incidents, lessons, skills, rules
Settings	Cmd+,	Project configuration
Worktree Status	-	Git branch and file status

Architecture

sidstack/
├── src/                   # React frontend (Tauri)
├── src-tauri/             # Rust backend (Tauri)
├── packages/
│   ├── mcp-server/        # MCP Server (npx-ready)
│   ├── api-server/        # REST API (Express.js, central gateway)
│   ├── cli/               # CLI (init, update, scan, skills, desk)
│   ├── bot-server/        # SidBot (Gemini intent router)
│   ├── web-ui/            # React SPA (browser access)
│   └── shared/            # Repository layer + shared types
├── .sidstack/             # Project data (config, knowledge)
│   ├── governance.md      # Master governance doc
│   └── knowledge/         # Project knowledge docs (9 categories)
├── .claude/               # Claude Code integration
│   ├── hooks/             # Lifecycle hooks (quality gates, bootstrap)
│   ├── skills/            # Auto-triggered agent skills
│   ├── agents/            # Worker + Reviewer agent definitions
│   └── commands/          # Custom slash commands
├── docker/                # Docker deployment configs
└── docs/                  # Documentation

Tech Stack

Component	Technology
Desktop App	Tauri 2.x (Rust + React)
Frontend	React 19, Tailwind CSS, Zustand
Database	SQLite (better-sqlite3, embedded)
MCP Server	@modelcontextprotocol/sdk
CLI	Oclif (TypeScript)
API Server	Express.js

Development

pnpm install               # Install dependencies
pnpm dev                   # Vite dev server (frontend)
pnpm tauri:dev             # Full Tauri app (Rust + React)
pnpm packages:build        # Build all packages
pnpm test                  # Run tests
pnpm typecheck             # TypeScript check

Documentation

• Quick Start - Setup guide for MCP and Desktop
• Claude Code Integration - MCP configuration
• API Reference - REST API documentation
• Contributing - Development setup and PR guidelines

License

MIT