DevThread.
Install DevThread

An Agent Skill for your repository

Know what’s built.
See what’s next.

Keep AI development on track.

Give your coding agent a project map it can read every session. DevThread keeps repository findings, tasks, and check results beside your code, so the agent can recommend work with a clear reason.

Install DevThread Explore the example 
npx devthread install

Node.js 22+ for npm installation · Python 3 for local scripts

Open source · MITUses your coding agent’s model and tools
Taskboard · before implementation
Repository inspectedtaskboard/src/ · tests/ · AGENTS.md
Observed
Agent saves the findings
Context in your repository.devthread/
PROJECT.mdPurpose & constraints
tasks/TASK-002.mdCriteria & dependencies
reports/Commands & outcomes
Agent explains the next action
TASK-002 · next actionReady
Complete a task without changing its ID
Why it can start
TASK-001 is done; add/list checks pass.
What is missing
No completion operation found in the inspected source.

Implement completion, then check ID preservation and unknown-ID behavior.

Condensed from the recorded example. Read the search, tests, and final state

YOUR CODE. YOUR CONTEXT. A CLEAR NEXT STEP.Explore the workflow

01 / The problem

The session ends.
The project keeps going.

A new chat needs the decisions, constraints, and unfinished work that matter. Save those details where the next session can read them.

01

Agents lose project context

Decisions and unfinished work are scattered across earlier conversations.

02

Plans fall out of sync with code

A roadmap can say “done” while the implementation still has gaps.

03

Completed work needs verification

A changed file needs a check tied to the behavior you expected.

02 / The workflow

You set the goal.
Your agent follows the workflow.

Read the workflow reference
  1. 01

    Install

    You · terminal

    Run the npm command to copy the skill into .agents/skills/devthread/. Your project map is created later.

  2. 02

    Understand

    You ask · agent inspects

    Ask the agent to read your instructions, source, tests, and saved context. It reports facts, inferences, and unknowns.

  3. 03

    Map

    You set a goal · agent plans

    Ask to initialize .devthread/ and plan a bounded goal. Review the Markdown tasks, criteria, and dependencies it writes.

  4. 04

    Reconcile

    You ask · agent compares

    Ask the agent to compare the plan with code and available check results. It records gaps and conflicting evidence.

  5. 05

    Resume

    You open a new chat

    Ask for status and the next task. The agent reads the saved files and explains which work can start and why.

Start with “Use $devthread to understand this repository.”

Workflows run when you ask the host agent. Planning updates .devthread/; source edits require an implementation request. Ask for verification to run relevant available checks.

03 / What you keep

A useful map.
A reviewable trail.

The map is a set of Markdown and JSON files you can inspect, edit, and version with the project.

Context the next
session can read.

The agent recovers the plan from saved files. You can review the same context before approving work.

  • PROJECT.mdPurpose and current state
  • ARCHITECTURE.mdFindings and inferences
  • DECISIONS.mdApproved choices
tasks/TASK-002.md

Tasks with clear boundaries.

Scope, dependencies, and acceptance criteria explain what to build and when it can start.

REQUIREMENTS.md → ROADMAP.md

A plan linked to real work.

Stable requirement and task IDs connect your goals to the code and checks inspected by the agent.

reports/

Checks you can trace.

Exact commands and passed, failed, or not-run outcomes show which claims have evidence.

config.json · Markdown files

A map you can keep.

The context stays inside your repository. DevThread needs no service or model API of its own.

04 / A concrete example

The recommendation
comes with a reason.

Recorded example · Taskboard
Developer prompt

“Compare the roadmap with the code. What can I work on next?”

Before implementation · condensed result

TASK-002 can start.

✓ Verified Dependency satisfied
TASK-001 is done. Two baseline tests cover adding and listing tasks.
◇ Missing Completion operation
A bounded search of src/ and tests/ found no completion implementation.

Next action: implement completion, then verify preserved IDs, unchanged other tasks, and unknown-ID behavior.

Read the full tested session
tasks/TASK-002.md · excerpt before implementation
---
id: TASK-002
title: "Complete a task without changing its ID"
status: ready
priority: high
depends_on: [TASK-001]
requirements: [REQ-002]
---

## Acceptance Criteria
- Completing an ID preserves that ID.
- Other tasks remain unchanged.
- An unknown ID leaves stored data unchanged.

## Evidence
Assessment: missing.
No completion operation found in src/ or tests/.
✓ Four tests passed

After implementation: the recorded checks verified the stated criteria. TASK-002 stayed in review awaiting acceptance. The report retains the earlier failure and a not-run concurrency check.

Observed
Found during inspection; behavior may still need a check.
Verified
The stated criteria have recorded passing checks or review.
Missing
A bounded search found no implementation evidence.
In review
Work awaits verification or explicit acceptance, even when some checks pass.

Evidence describes the checks performed. Task status describes progress. Read the evidence definitions and task lifecycle.

05 / Compatibility

Tested where
we can show the evidence.

Results are recorded per environment and type of check. The npm installer copies the skill; the coding agent interprets its instructions.

See the compatibility matrix
Windows · Linux · macOSInstaller, packed archive, and Python scripts
CI: Node 22/24 · Python 3.13 · 12 Oct 2026
✓ CI passed
npm registry installationWindows · Node 22.18.0 · Python 3.13
File fidelity and bundled scripts · 12 Oct 2026
✓ Checked
Codex discoveryDevThread loaded on Windows from .agents/skills/
Separate fresh-chat workflow review pending
Observed
Other coding agentsInstallation and workflows need their own checks
? Untested

06 / Open source

Keep the map close to the code.

MIT licensed · Published as devthread@0.1.0
Help improve the skill, its examples, or its tested compatibility.

View on GitHub Read about safety and privacy →

Start with the repository you have.

Give your next session
a place to begin.

npx devthread install

Node.js 22+ for installation · Python 3 for local scripts · Your coding agent for the workflows

Install DevThread

Then try the existing repository quick start.