Shared context board for teams and agents
Try Kanwas for free at kanwas.ai
# What's Kanwas? Kanwas is a multiplayer workspace for AI work. Teams and an AI agent share the same documents, evidence, and decisions, with the agent's tool calls streaming into the same timeline everyone sees.  ## Who it's for - **Founders.** Turn a fundraising deck, customer interviews, MVP spec, and hiring plan into one canvas where the agent helps across all of them. Less context to keep in your head, more output across many fronts. - **Product managers.** Drop interview snippets, tickets, and competitor screenshots on a board; get a discovery readout and a PRD with every claim traceable to its source. - **Developers.** Pull a PM's spec, designs, and research onto a canvas; work with the agent to turn it into an implementation plan with tasks and acceptance criteria. Then `kanwas pull` the markdown into your repo and hand it to Claude Code, Codex, or whatever coding agent you use. - **Marketers.** Plan a launch with positioning, messaging, asset list, and timeline. The agent drafts copy variants you can compare side-by-side and iterate on with the team. - **Sales.** A reusable account board: research, comms history, stakeholder map, and proposal drafts. Each deal makes the template better. ## Why teams use it - **Shared context that compounds.** Every decision and outcome makes the next board better than the last. - **Canvas + agent on one surface.** Work alongside AI over the same evidence, ideas, and trade-offs โ transparent to everyone. - **Sharp deliverables in minutes.** Generate structured, execution-ready artifacts for every stage of the work. - **Your files, your repo.** Git-backed markdown filesystem with full version history. No vendor lock-in. ## Quickstart ### Prerequisites - Docker + Docker Compose - An Anthropic API key (and/or OpenAI API key) ### Run it ```bash git clone https://github.com/kanwas-ai/kanwas.git cd kanwas # Env files โ fill in API keys, APP_KEY, etc. cp .env.example .env cp backend/.env.example backend/.env cp yjs-server/.env.example yjs-server/.env cp frontend/.env.example frontend/.env docker-compose --profile app up ``` Open http://localhost:5173 and you're in. For local development (hot reload, running services with `pnpm dev`) and the architectural walkthrough, see [`docs/SYSTEM_OVERVIEW.md`](./docs/SYSTEM_OVERVIEW.md). ## CLI `kanwas` is a command-line tool for syncing a workspace with your local filesystem. Useful when you want to edit notes in your editor of choice, bulk-import markdown you already have on disk, or script workspace access from CI or another agent. ### Install ```bash npm install -g @kanwas/cli ``` ### Authenticate ```bash kanwas login ``` Opens a browser tab to authorize the CLI. Auth is stored globally in `~/.kanwas/config.json`. ### Edit a workspace locally ```bash mkdir my-workspace && cd my-workspace kanwas pull # interactive picker, downloads files into the current directory # ...edit files in your editor... kanwas push # uploads local changes back to the workspace ``` After the first `pull`, the directory is bound to that workspace via `.kanwas.json`. Subsequent `pull` / `push` reuse it automatically. ### Import markdown from disk ```bash kanwas import ./notes # interactive workspace picker kanwas import ./notes --name "My Workspace" # non-interactive, by name kanwas import ./intro.md --id