Your AGENTS.md should grow from your scars, not from a template. A local-first Claude Code companion.
Project description
FrictionLog
Your AGENTS.md should grow from your scars, not from a template. A local-first Claude Code companion.
Status: 🚧 WIP — Sprint 1 (project scaffolding). Not yet usable.
What it is
FrictionLog watches your Claude Code sessions and only records correction moments — the times you push back, undo an edit, or tell the AI "no, do X instead." Once a week, it generates a markdown digest of your top recurring frictions and drafts AGENTS.md rules you can copy-paste.
It does not analyze your code. It does not phone home. It does not tell you how to be a better engineer.
What it is not
- ❌ Not a memory plugin (we do not store preferences)
- ❌ Not a SaaS (everything stays in
~/.frictionlog/) - ❌ Not an AGENTS.md template library
Roadmap (8 weeks)
| Milestone | Date | What |
|---|---|---|
| M0 | 2026-05-21 | Project scaffolding + private repo + PyPI placeholder |
| M1 | 2026-06-04 | fl init / fl recent / fl pattern |
| M2 | 2026-06-18 | Semi-manual friction detection |
| M3 | 2026-07-02 | Weekly digest + stale-rule suggestions |
| M4 | 2026-07-09 | Public v0.1.0 on PyPI |
License
MIT. See LICENSE.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file frictionlog-0.0.1.tar.gz.
File metadata
- Download URL: frictionlog-0.0.1.tar.gz
- Upload date:
- Size: 44.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
01b231b9b2cd7d32a2e21f5f00745b190340e08e96d9264384cbe87b7bb7ad88
|
|
| MD5 |
93e63eb06d4315018924b7f7a6b3475b
|
|
| BLAKE2b-256 |
6b18802210c3b137ac3f74a8b5ce8147e9a543ba42dd283b347bc05a64e1fbcf
|
File details
Details for the file frictionlog-0.0.1-py3-none-any.whl.
File metadata
- Download URL: frictionlog-0.0.1-py3-none-any.whl
- Upload date:
- Size: 9.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c3bad5e8ee711c2af70ad87a514574f928eb7743badf47b656c21444c4442a5b
|
|
| MD5 |
ab74a3b6ef6de7c085fc4d1369452114
|
|
| BLAKE2b-256 |
8679cbf1ab289922e7b97a6d375244f3cdf0663d623ae9dd63affdfd0835c431
|