{"_id":"@buttfart_os/buttcore","name":"@buttfart_os/buttcore","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@buttfart_os/buttcore","version":"0.1.0","description":"Drop-in markdown files that teach AI agents to learn and evolve from your habits","publishConfig":{"access":"public"},"type":"module","bin":{"buttcore":"dist/bin/buttcore.js"},"main":"./dist/src/index.js","types":"./dist/src/index.d.ts","scripts":{"build":"tsup src/index.ts bin/buttcore.ts --format esm --dts --outDir dist","dev":"tsup src/index.ts bin/buttcore.ts --format esm --watch","test":"vitest","prepublishOnly":"npm run build"},"keywords":["ai","agent","memory","learning","evolution","cursor","claude","copilot","soul","prompt"],"license":"MIT","dependencies":{"chalk":"^5.3.0","commander":"^12.1.0","glob":"^11.0.0","gray-matter":"^4.0.3","inquirer":"^9.3.0"},"devDependencies":{"@types/inquirer":"^9.0.7","@types/node":"^22.0.0","tsup":"^8.2.0","typescript":"^5.5.0","vitest":"^2.0.0"},"engines":{"node":">=18.0.0"},"_id":"@buttfart_os/buttcore@0.1.0","_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-+hX/v3gd5mdHdycZv6YBIHsoczhkXtjS0XrdABhXg+77V8MLwG/BFmvZ2vIg8ro8OGZMr2JF8iNnSNeCoK/OYw==","shasum":"41da199eba42c86694c058a820ae6e4dc3aa0342","tarball":"https://registry.npmjs.org/@buttfart_os/buttcore/-/buttcore-0.1.0.tgz","fileCount":29,"unpackedSize":100229,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCoY7VHme+EKI/sB2TNLMmfybYCZjefkNg1ZO/WwjZBeAIgZDFExrKvhSChq89SHyHHssVbCHBlO47yAb040PSQJ/0="}]},"_npmUser":{"name":"bfos_system","email":"100yogurts@pm.me"},"directories":{},"maintainers":[{"name":"bfos_system","email":"100yogurts@pm.me"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/buttcore_0.1.0_1780441346824_0.0009337052070548246"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-02T23:02:26.716Z","0.1.0":"2026-06-02T23:02:27.085Z","modified":"2026-06-02T23:02:27.276Z"},"maintainers":[{"name":"bfos_system","email":"100yogurts@pm.me"}],"description":"Drop-in markdown files that teach AI agents to learn and evolve from your habits","keywords":["ai","agent","memory","learning","evolution","cursor","claude","copilot","soul","prompt"],"license":"MIT","readme":"# ButtCore\n\nDrop-in markdown files that teach AI agents to learn and evolve from your habits.\n\n## What This Is\n\nButtCore is a set of markdown files you drop into any project directory. As you work with any AI agent — Claude, GPT, Cursor, Copilot, Codex, Gemini — the system observes, learns, distills, and updates itself.\n\nIt maintains a living `SOUL.md` file: a continuously evolving instruction set that reflects your preferences, communication style, technical decisions, corrections, and patterns.\n\n**No database. No API keys. No configuration. Just markdown and intelligence.**\n\n## Install\n\n```bash\nnpx buttcore init\n```\n\nThis creates:\n- `~/.buttcore/` (global, shared across all projects)\n  - `SOUL.md` — Living identity and preferences\n  - `PATTERNS.md` — Cross-project patterns\n  - `MISTAKES.md` — Process failure lessons\n  - `LEXICON.md` — Your personal vocabulary\n- `.buttcore/` (local to this project)\n  - `PROJECT.md` — Project-specific context\n  - `SESSION_LOG.md` — Rolling session history\n  - `CORRECTIONS.md` — Correction tracking\n- `AGENTS.md` — Cross-tool bridge file\n\n## How It Works\n\n1. **Agent reads** ButtCore files at session start\n2. **You work** with the agent normally\n3. **When corrected**, the agent logs to CORRECTIONS.md\n4. **When patterns emerge** (3+ similar corrections), the Distillation Process triggers\n5. **Distilled knowledge** flows to the appropriate file (SOUL.md, MISTAKES.md, LEXICON.md, PATTERNS.md)\n6. **Next session**, the agent is better\n\nThe learning is real. Not \"I'll try harder\" — structural, persistent, versioned knowledge that survives across sessions, projects, and even different AI tools.\n\n## Commands\n\n| Command | What it does |\n|---------|-------------|\n| `buttcore init` | Initialize ButtCore in current project |\n| `buttcore onboard` | Interactive questionnaire to pre-populate SOUL.md |\n| `buttcore status` | Show current learning state |\n| `buttcore compact` | Compress old session logs |\n| `buttcore export` | Export all knowledge to a single file |\n| `buttcore doctor` | Validate file integrity |\n\n## Philosophy\n\n### Global vs Local\n\nButtCore enforces a strict scope boundary:\n\n- **Global** (`~/.buttcore/`): Who you are. Applies everywhere.\n- **Local** (`.buttcore/`): What this project is. Stays here.\n\nProject-specific data never leaks into global files. Global knowledge is abstract and generalizable.\n\n### Confidence Escalation\n\nNot every observation becomes a rule:\n\n| Signal | Where it goes | Confidence |\n|--------|--------------|------------|\n| 1 occurrence | SESSION_LOG.md | — |\n| 2 occurrences | SOUL.md | low |\n| 5 occurrences | SOUL.md | medium |\n| 10+ occurrences | SOUL.md | high |\n\n### The Agent Learns From Its Mistakes\n\nMISTAKES.md doesn't just record what the user wants — it records what the agent got wrong and why. \"I defaulted to complex when the user meant simple\" is more valuable than \"user prefers simple.\"\n\n## Works With\n\nAny AI agent that can read files in your project:\n- Claude Code / Claude Desktop\n- Cursor (reads AGENTS.md + .cursor/rules/)\n- GitHub Copilot (reads AGENTS.md)\n- OpenAI Codex\n- Windsurf\n- Aider / OpenCode / Goose\n- Any custom agent with filesystem access\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-65ac911eca6cee34f9ae403049530009"}