Home/AI Agents/planning-with-files
planning-with-files logo

planning-with-files

OthmanAdi/planning-with-files

Persistent file-based planning for AI coding agents

GraphCanon updated Sep 20, 2026 · GitHub synced Sep 20, 2026

104views this month

27k stars2.3k forksLast push Sep 19, 2026 Shell MIT

Decision brief

A tool designed for providing persistent file-based planning in long-running AI coding tasks.

Good fit when

  • - When your coding agent needs to retain plans across sessions without context loss.
  • - For supporting multi-agent shared state, ensuring all agents have the most updated plan on disk.

Avoid when

  • - When you do not need persistent storage for plans, such as short tasks where context is unlikely to be lost.
  • - For projects that strictly prohibit the use of external file storage for tracking progress due to security concerns.
Pricing:
freemium - Freely available under MIT License; community-supported.

Observed Jul 11, 2026 · Source: enrich:decision_facts

Verify the decision

Maintenance and security

Full trust report
Maintenance
Very active (0d since push)
As of Sep 20, 2026
Provenance
Not a fork · Personal account
As of Sep 20, 2026
Security (OSV)
No lockfile
As of Jul 11, 2026

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

git clone https://github.com/OthmanAdi/planning-with-files

How it fits your stack(12)

Typed graph edges - alternatives, integrations, successors, and dependencies. Ranked by relationship type, not raw GitHub stars.

Related

Relationship graph

Optional deeper exploration of typed edges and category neighbours.

Similar tools

Same-category neighbours not already linked as typed edges.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

Provides crash-proof markdown plans that survive context loss in long-running agentic tasks. Supports multi-agent shared state on disk through a deterministic completion gate.

Capability facts

Languages
shell

Source: github.language · Sep 20, 2026

Categories

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

Node.js runtimeNode.js

Source: README excerpt (regex_v1, Sep 20, 2026)

npm install planning-with-files
Source link

Tags

README

Quick Install Claude Code, plugin route (ships everything: skill, hooks, slash commands): Every other agent , one line, 60+ agents via the Agent Skills standard: npm , to pin an exact version into a project or vendor it: The package carries , and , so this is the route for lockin...

For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.