Skip to content

Klondike

Manage agent workflow artifacts for long-running AI coding sessions

Klondike is a CLI tool designed to maintain coherence across long-running AI coding sessions. It provides structured artifacts that bridge context windows, helping AI agents pick up exactly where they left off.

Why Klondike?

AI coding agents face a fundamental challenge: each session starts fresh. Without proper context management, agents:

  • ❌ Lose track of what was done
  • ❌ Repeat work unnecessarily
  • ❌ Declare premature "victory" on incomplete features
  • ❌ Leave code in broken states

Klondike solves this by providing:

  • ✅ Feature Registry - Track what needs to be done and what's complete
  • ✅ Session Management - Record context for handoffs between sessions
  • ✅ Progress Tracking - Generate handoff documents automatically
  • ✅ Validation - Ensure artifacts are consistent and complete

Quick Example

# Initialize a new project
klondike init --name my-project

# Add features to track
klondike feature add "User authentication" --category core --priority 1

# Start a coding session
klondike session start --focus "F001 - User authentication"

# Work on the feature...
klondike feature start F001

# When done, verify with evidence
klondike feature verify F001 --evidence "tests/auth.test.js"

# End the session with handoff notes
klondike session end --summary "Completed login flow" --next "Add password reset"

Core Concepts

Features

Features are discrete units of work with clear acceptance criteria. Klondike prevents "victory declaration" by requiring evidence before marking features complete.

Learn more about features →

Sessions

Sessions represent a continuous work period. Starting and ending sessions creates breadcrumbs that help the next agent (or human) pick up where you left off.

Learn more about sessions →

Progress Artifacts

Klondike maintains structured JSON artifacts in .klondike/ and generates human-readable markdown (agent-progress.md) for easy review.

Learn more about configuration →

Getting Started

  • Installation

    Install Klondike with pip in under a minute

    Install

  • Quick Start

    Get up and running with your first project

    Quick Start

  • Guides

    Deep dives into features, sessions, and workflows

    Guides

  • CLI Reference

    Complete command documentation

    Reference

Inspired By

Klondike is inspired by Anthropic's research on effective harnesses for long-running agents. The key insight: create structured artifacts that bridge context windows.