Skip to content

junixlabs/sidstack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

SidStack

CI npm License: MIT

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

License

MIT

About

Give Claude Code persistent project memory. 32 MCP tools for knowledge, impact analysis, governance & task management. Desktop app (Tauri) + CLI. Local-first, SQLite-based.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors