Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

frictionlog-0.0.1.tar.gz (44.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

frictionlog-0.0.1-py3-none-any.whl (9.0 kB view details)

Uploaded Python 3

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

Hashes for frictionlog-0.0.1.tar.gz
Algorithm Hash digest
SHA256 01b231b9b2cd7d32a2e21f5f00745b190340e08e96d9264384cbe87b7bb7ad88
MD5 93e63eb06d4315018924b7f7a6b3475b
BLAKE2b-256 6b18802210c3b137ac3f74a8b5ce8147e9a543ba42dd283b347bc05a64e1fbcf

See more details on using hashes here.

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

Hashes for frictionlog-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c3bad5e8ee711c2af70ad87a514574f928eb7743badf47b656c21444c4442a5b
MD5 ab74a3b6ef6de7c085fc4d1369452114
BLAKE2b-256 8679cbf1ab289922e7b97a6d375244f3cdf0663d623ae9dd63affdfd0835c431

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page