Introduction

Kora is a git-native task management system designed for high-velocity development environments. It provides a decentralized, file-based workflow where tasks are stored as structured markdown files directly within your repository.

Architecture

Unlike traditional task managers that rely on centralized databases, Kora operates on a local-first principle. All task data is stored in the .kora/ directory of your project. This approach offers several technical advantages:

  • ✓Atomic Versioning: Tasks are branched and merged alongside your code.
  • ✓Agent Compatibility: AI agents can interact with tasks using standard file I/O operations.
  • ✓Offline Access: Full functionality without an internet connection.
  • ✓Zero Lock-in: Tasks are plain text files (Markdown + YAML frontmatter).
💡
If you are migrating from another tool, you can use the kora import command (experimental) to bring in your existing data.

Quick Start

1

Installation

Install the Kora CLI globally via npm. This provides the kora binary.

bash
❯
npm install -g kora-dev
2

Initialization

Initialize Kora in any git-initialized directory. This creates the .kora/ schema.

bash
❯
kora init
3

Task Creation

Create a task. This generates a new .md file in .kora/tasks/.

bash
❯
kora create "Implement JWT Auth" --priority high
4

Interactive Board

Launch the terminal user interface (TUI) to manage the Kanban board.

bash
❯
kora board