Task File Format

Kora uses a transparent, git-native storage format. Every task is a plain Markdown file with YAML frontmatter, stored directly in your repository. This ensures your project data is portable, version-controlled, and human-readable.

ℹ️

Tasks are stored in the .kora/tasks/ directory within your project root.

File Structure

A Kora task consists of standard YAML frontmatter for metadata and a Markdown body for descriptions and documentation.

TASK-a4f2b3.md

---
id: TASK-a4f2b3
title: Build OAuth login flow
status: in-progress
priority: high
labels:
  - auth
  - security
assigned_to: 
  id: claude-3-7-sonnet
  type: agent
---
## Description
Implement OAuth2 login using NextAuth.js...

Git Strategy

Because tasks are just files, they inherit all the power of git:

Branching

Keep task status in sync with feature branches.

History

Audit every change with git blame and git log.

Conflicts

Resolve status conflicts using standard merge tools.

Search

Use grep or ripgrep to find tasks across your whole history.

Metadata Schema

The following fields are strictly typed within the YAML frontmatter:

idUnique task identifier (e.g., TASK-001).

statusCurrent state (backlog, todo, in-progress, done).

priorityImportance (low, medium, high, urgent).

labelsList of strings for categorization.

assigned_toObject containing agent or human ID and type.

← Agent Integrations