Directory-contained markdown fibers with YAML frontmatter and wikilinks. A lightweight substrate for accumulating context — decisions, claims, tasks, questions, specs — and keeping it searchable, connected, and round-trippable through whatever tooling layers on top.
// readme
felt
When work spans several days or coding-agent sessions, decisions and unfinished tasks can disappear into chat transcripts. felt keeps them in Markdown files beside your project, with a command-line tool for recording, searching, and connecting them. You and your agents read and write the same notes; Git keeps their history.
Set up with your agent
Shuttle is the optional task board that launches agents and follows their work. We recommend asking your existing agent to help you set it up. Give it this prompt:
Read https://cailmdaley.github.io/felt/shuttle/agent-setup/ and help me set up Shuttle. Record this setup as a task on the board, and give me the board URL when it is ready.
The setup guide explains what to expect. To use felt for notes on its own, follow the commands below.
Keep project notes
Each note is called a fiber.
It can hold a task, a question, a decision, a finding, or a project specification.
A fiber lives in its own directory under .felt/, with metadata above its Markdown body:
---
name: Choose a…