planning-with-files

(★ 26,267)

Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60+ agents.

File Explorer

  • .gitattributes
  • .gitignore
  • AGENTS.md
  • CHANGELOG.md
  • CITATION.cff
  • CONTRIBUTING.md
  • CONTRIBUTORS.md
  • LICENSE
  • llms.txt
  • MIGRATION.md
  • README.md
  • SECURITY.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Release Timeline

Actively Maintained

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

dash

View Details ▼

Debian Almquist Shell, a modern, POSIX-compliant implementation of `sh` (not Bash-compatible).

dash

Start an interactive shell session:

dash -c "{{echo 'dash is executed'}}"

Execute specific [c]ommands:

dash {{path/to/script.sh}}

Execute a specific script:

🔍

git clone

View Details ▼

Clone an existing repository.

git clone {{remote_repository_location}} {{path/to/directory}}

Clone an existing repository into a new directory (the default directory is the repository name):

git clone --recursive {{remote_repository_location}}

Clone an existing repository and its submodules:

git clone {{[-n|--no-checkout]}} {{remote_repository_location}}

Clone only the `.git` directory of an existing repository:

🔍

git push

View Details ▼

Push commits to a remote repository.

git push

Send local changes in the current branch to its default remote counterpart:

git push {{remote_name}} {{local_branch}}

Send changes from a specific local branch to its remote counterpart:

git push {{[-u|--set-upstream]}} {{remote_name}} {{local_branch}}

Send changes from a specific local branch to its remote counterpart, and set the remote one as the default push/pull target of the local one:

🔍

npm install

View Details ▼

Install Node packages.

npm {{[i|install]}}

Install dependencies listed in `package.json`:

npm {{[i|install]}} {{package_name}}@{{version}}

Download a specific version of a package and add it to the list of dependencies in `package.json`:

npm {{[i|install]}} {{package_name}} {{[-D|--save-dev]}}

Download the latest version of a package and add it to the list of dev dependencies in `package.json`:

🔍

npx

View Details ▼

This command is an alias of `npm exec`.

tldr npm exec

View documentation for the original command:

🔍

python3

View Details ▼

This command is an alias of `python`.

tldr python

View documentation for the original command:

🔍

realpath

View Details ▼

Display the resolved absolute path for a file or directory.

realpath {{path/to/file_or_directory}}

Display the absolute path for a file or directory:

realpath {{[-e|--canonicalize-existing]}} {{path/to/file_or_directory}}

Require all path components to exist:

realpath {{[-L|--logical]}} {{path/to/file_or_directory}}

Resolve `..` components before symlinks:

🔍

flock

View Details ▼

Manage file locks from shell scripts.
It can be used to ensure that only one instance of a command is running.

flock {{path/to/lock.lock}} {{command}}

Run a command with a file lock as soon as the lock is available:

flock {{[-n|--nonblock]}} {{path/to/lock.lock}} {{command}}

Run a command with a file lock, or exit if the lock is currently being held (with exit code 1):

flock {{[-n|--nonblock]}} {{[-E|--conflict-exit-code]}} {{123}} {{path/to/lock.lock}} {{command}}

Run a command with a file lock, or exit with a specific error code if the lock is currently being held:

🔍

compact

View Details ▼

Display or change the compression state of files and directories on NTFS partitions.

compact

Display the compression status of files in the current directory:

compact /c {{path\to\file}}

Compress a specific file:

compact /u {{path\to\file}}

Uncompress a specific file:

// repository documentation