repowiseusekaneo/kaneo

usekaneo / kaneo

🎯 All you need. Nothing you don't. Open source project management that works for you, not against you.

TypeScript★ 9,356
Use in your agentAsk this codebase

github.com/usekaneo/kaneoIndexed at ee36e49Up to date with upstream

What is kaneo?

kaneo is an open-source project management application for teams that want a focused, self-hosted way to manage work. Its web client uses an API backed by PostgreSQL, and its TypeScript monorepo also provides MCP access for AI tools. The project is primarily written in TypeScript.

Written by a model from the README and the source

1,642 files and 4,317 symbols in 7 modules, led by TypeScript (1,245 files) and JavaScript (14).

Start reading

Code health

7.1out of 10Good

Hotspots average 4.8, the place fixes pay off most.

Full health report

On the leaderboards:#28 of 46 TypeScript repos

Use usekaneo/kaneo in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/usekaneo/kaneo
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is kaneo put together?")
  • get_why("why is kaneo structured this way?")

Explore kaneo

Key features of kaneo

  • Kaneo provides a clean interface focused on project work.
  • Kaneo supports self-hosting so teams can keep their data under their control.
  • Kaneo is open source under the MIT license.
  • Kaneo provides an official MCP server for AI tools to manage tasks, projects, and labels.
  • Kaneo supports deployment with Docker Compose, Coolify, and Kubernetes Helm charts.

How usekaneo/kaneo works

Kaneo's web client sends requests to the API, which exposes OpenAPI-described endpoints and uses PostgreSQL for persistence. The API entry point in apps/api/src/index.ts starts the server and connects the backend services. Real-time communication is organized in apps/api/src/ws/index.ts, which configures broadcasting for connected clients through in-memory or Redis-backed adapters. The MCP integration in apps/api/src/mcp/index.ts exposes Kaneo capabilities through the built-in /api/mcp endpoint. The apps directory holds the main application code, while packages holds shared package-level functionality. The i18n/resources.ts file assembles locale resources for web internationalization consumers.

The codebase has 1,642 files and 4,317 symbols in 7 modules, led by TypeScript, JavaScript and Shell. Code health is 7.1 out of 10, rated good.

Getting started with kaneo

  1. Install dependencies for development.
    pnpm install
  2. Start the development servers.
    pnpm dev
  3. Run the one-click setup tool.
    drim setup

Commands copied from the README

usekaneo/kaneo FAQ

What is kaneo?

kaneo is an open-source project management application for focused team work. Kaneo is self-hosted and uses a web client, an API, and PostgreSQL.

How does kaneo work?

kaneo's web client communicates with an API backed by PostgreSQL. Kaneo also exposes capabilities through an HTTP MCP endpoint and the @kaneo/mcp package for stdio clients.

How do I install kaneo?

kaneo can be installed for development with pnpm install, or set up with drim setup. Docker Compose can start Kaneo and PostgreSQL with docker compose up -d.

What language is kaneo written in?

kaneo is primarily written in TypeScript. Its repository also includes JavaScript, shell, and Dockerfile files.

How is the kaneo code organized?

kaneo is organized as a monorepo with application code in apps, shared packages in packages, tests in tests, and localization resources in i18n. The API is in apps/api and the web client is in apps/web.

Who is kaneo for?

kaneo is for teams that want project management focused on building products. Kaneo is designed for self-hosted use and supports managing tasks, projects, and labels through MCP tools.

What license does kaneo use?

kaneo uses the MIT license. Kaneo is open source and supports self-hosted deployments.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of usekaneo/kaneo from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.