KanClaw

Premium Local-First Workspace OS for AI Agent Teams

stars forks issues license

Next.js React TypeScript Tailwind Prisma SQLite Tauri

Español · Architecture · Docs Landing · Open Issues

🧭 Who is this for?

• Founders shipping product features with AI copilots
• Indie hackers who need speed without losing traceability
• Small teams coordinating agent runs with persistent context

KanClaw helps you move fast with AI while keeping structure, auditability, and delivery quality.

📚 Table of Contents

• Why KanClaw
• Feature Highlights
• Screenshots
• Quick Start
• Tech Stack
• Project Structure
• Available Scripts
• Roadmap
• Contributing

🚀 Why KanClaw

KanClaw is a local-first workspace OS where humans + AI agents collaborate with persistent context, structured memory, and production-ready team workflows.

✨ Feature Highlights

• Workspace Shell: focused, cinematic interface with command palette and context rails
• Agent Collaboration: team room, per-agent channels, real task execution traces
• Memory Hub: queryable knowledge, decision records, artifacts and run history
• Project Ops: tasks, snapshots, imports, and structured execution loops
• Desktop-ready: native packaging via Tauri 2

🖼 Screenshots

_{Click any screenshot to open full resolution.}

Screenshots are maintained in ./screenshots and verified against real file paths.

⚡ Quick Start

1) Clone and install

git clone https://github.com/smouj/kanclaw.git
cd kanclaw/frontend
npm install

2) Configure environment

cp .env.example .env

3) Initialize database

npm run db:generate
npm run db:push
# optional demo data
npm run seed

4) Run development server

npm run dev

Open: http://localhost:3000

🧱 Tech Stack

🗂 Project Structure

kanclaw/
├── frontend/            # Next.js app
├── backend/             # Legacy Python backend
├── docs/                # Landing + static docs
├── screenshots/         # README visual assets
└── ARCHITECTURE.md      # High-level architecture

🛠 Available Scripts

🖥 Desktop Installation (Tauri)

KanClaw can be installed as a native desktop app via Tauri 2.

Requirements

• Node.js 20+
• Rust toolchain (rustup, cargo)
• OS dependencies required by Tauri

Build installer

cd frontend
npm install
npm run build
npm run desktop:prepare-sidecar
npm run desktop:build

Generated installers/bundles are available under:

frontend/src-tauri/target/release/bundle/

For local desktop testing without packaging, use npm run desktop:dev.

🗺 Roadmap

• One-command CLI installer
• Multi-project templates and starter packs
• Live analytics + observability overlay
• Expanded automation library for agent workflows

📈 Why teams share KanClaw

• Clear product story (local-first + agent workflows)
• Professional visual identity and premium UX
• Practical setup (Next.js + Prisma + SQLite + Tauri)
• Ready for rapid iteration and public demos

🖼 Repository Banner / Social Preview

A production-ready social banner is included at:

• assets/social/github-social-preview.png (1280×640)
• assets/social/github-social-preview.svg (editable source)

To activate it on GitHub:

1. Open Repo → Settings → General
2. Scroll to Social preview
3. Upload assets/social/github-social-preview.png

This improves link previews and repository click-through on social channels.

🤝 Contributing

PRs are welcome. For major changes, open an issue first to align on scope, UX direction, and architecture.

Support the project

If KanClaw helps your workflow:

• ⭐ Star the repository
• 🍴 Fork and build your flavor
• 🐛 Report issues with reproducible steps
• 📣 Share it with #aiagents and #buildinpublic communities