monolith-ai 0.1.9__tar.gz

monolith_ai-0.1.9/.github/FUNDING.yml

@@ -0,0 +1,4 @@
+# Configures the "Sponsor" button shown at the top of the GitHub repo.
+# PayPal has no native key, so it is exposed via the `custom` URL list.
+custom:
+  - https://paypal.me/keyurpatel446

monolith_ai-0.1.9/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,27 @@
+---
+name: Bug report
+about: Something isn't working as expected
+title: "[bug] "
+labels: bug
+---
+
+**What happened**
+A clear, concise description of the bug.
+
+**To reproduce**
+Exact commands, e.g.:
+```bash
+monolith apply --agent all
+```
+
+**Expected behaviour**
+What you expected instead.
+
+**Environment**
+- Monolith version (`monolith --version`):
+- Python version (`python --version`):
+- OS:
+- Agent(s) affected (Claude Code / Codex / Copilot):
+
+**Additional context**
+Logs, generated file snippets, or anything else useful.

monolith_ai-0.1.9/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Question or idea
+    url: https://github.com/keyurpatel446/Monolith/discussions
+    about: Ask questions or share ideas in Discussions.

monolith_ai-0.1.9/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,18 @@
+---
+name: Feature request
+about: Suggest an idea or improvement
+title: "[feat] "
+labels: enhancement
+---
+
+**Problem**
+What are you trying to do that Monolith doesn't support today?
+
+**Proposed solution**
+What you'd like to happen (a command, a flag, an agent, etc.).
+
+**Alternatives considered**
+Any workarounds or other approaches.
+
+**Scope check**
+Does this keep the core dependency-free and the numbers honest? Any trade-offs?

monolith_ai-0.1.9/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,17 @@
+## Summary
+What does this change and why?
+
+## Type
+- [ ] Feature (`fetcher/<name>`)
+- [ ] Fix (`fix/<name>`)
+- [ ] Docs / chore
+
+## Checklist
+- [ ] Targets `develop` (not `master`).
+- [ ] Tests added/updated; `python -m unittest discover -s tests` passes.
+- [ ] No new runtime dependencies (or justified below).
+- [ ] Numbers stay honest (projected vs measured labelled).
+- [ ] `CHANGELOG.md` updated if user-facing.
+
+## Notes
+Anything reviewers should know.

monolith_ai-0.1.9/.github/copilot-instructions.md

@@ -0,0 +1,22 @@
+<!-- monolith:start -->
+<!-- Generated by Monolith. Do not edit between the markers; run `monolith apply` to regenerate. -->
+## Token-Efficiency Rules (Monolith - tier: full)
+
+GitHub Copilot: apply these custom instructions to keep responses concise and low-token across this repository.
+
+_Answer directly and densely. Use the fewest tokens that fully convey the answer._
+
+- Do not open with greetings, acknowledgements, or filler such as "Sure!", "Great question!", or "Certainly".
+- Do not end with pleasantries or offers of further help such as "I hope this helps!" or "Let me know if you need anything else."
+- Do not restate or paraphrase the request before answering.
+- Correct mistakes in one short sentence; do not apologize repeatedly.
+- Lead with the answer or the result; put caveats and context after, and only if they matter.
+- Do not append a summary of what you just did unless explicitly asked.
+- Prefer dense formats — tables, lists, and code blocks — over prose when they convey the same information in fewer tokens.
+- Do not narrate or re-explain code you just wrote unless asked; let the code and concise comments speak.
+- Write only comments that add non-obvious information; skip comments that merely restate the code.
+- Implement what was asked. Do not add speculative abstractions, options, or defensive code that was not requested.
+- Do not agree reflexively. If something is wrong or a better option exists, say so plainly and briefly.
+
+> User instructions in the conversation always override these rules.
+<!-- monolith:end -->

monolith_ai-0.1.9/.github/workflows/ci.yml

@@ -0,0 +1,82 @@
+name: CI
+
+# Tests run on every push/PR to master or develop. When code lands on master
+# (i.e. a merge), the `release` job reads the version from pyproject.toml and, if
+# no matching tag exists yet, creates the tag + GitHub release AND publishes to
+# PyPI. Publishing lives in this job (not a separate tag-triggered workflow)
+# because a tag pushed with GITHUB_TOKEN does not trigger other workflows.
+on:
+  push:
+    branches: [master, develop]
+  pull_request:
+    branches: [master, develop]
+
+jobs:
+  test:
+    name: Test (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install package
+        run: pip install -e .
+      - name: Run tests
+        run: python -m unittest discover -s tests -v
+
+  release:
+    name: Tag, release & publish on merge to master
+    runs-on: ubuntu-latest
+    needs: test
+    # Only on a real push (merge) to master, never on PRs or develop.
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+    environment: pypi  # matches the PyPI Trusted Publisher config
+    permissions:
+      contents: write  # push the tag + create the release
+      id-token: write  # PyPI Trusted Publishing (OIDC)
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # full history so we can see existing tags
+      - name: Read version from pyproject.toml
+        id: ver
+        run: |
+          VERSION=$(grep -m1 '^version' pyproject.toml | sed -E 's/.*"([^"]+)".*/\1/')
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "Detected version: $VERSION"
+      - name: Create tag + release if missing
+        id: tag
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          TAG="v${{ steps.ver.outputs.version }}"
+          if git rev-parse "$TAG" >/dev/null 2>&1; then
+            echo "Tag $TAG already exists; skipping release/publish."
+            echo "created=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag -a "$TAG" -m "Release $TAG"
+          git push origin "$TAG"
+          gh release create "$TAG" --title "$TAG" --generate-notes
+          echo "created=true" >> "$GITHUB_OUTPUT"
+      - name: Set up Python
+        if: steps.tag.outputs.created == 'true'
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Build distributions
+        if: steps.tag.outputs.created == 'true'
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      - name: Publish to PyPI (Trusted Publishing)
+        if: steps.tag.outputs.created == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1

monolith_ai-0.1.9/.gitignore

@@ -0,0 +1,25 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+env/
+
+# Test / coverage
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Editors / OS
+.idea/
+.vscode/
+.DS_Store
+
+# Monolith local state (generated per-project, not committed in consumer repos)
+.monolith/stats.json
+.monolith/gain.json
+.monolith/tee/

monolith_ai-0.1.9/.monolith/settings.json

@@ -0,0 +1,9 @@
+{
+  "tier": "full",
+  "agents": [
+    "claude",
+    "codex",
+    "copilot"
+  ],
+  "extra_rules": []
+}

monolith_ai-0.1.9/AGENTS.md

@@ -0,0 +1,22 @@
+<!-- monolith:start -->
+<!-- Generated by Monolith. Do not edit between the markers; run `monolith apply` to regenerate. -->
+## Token-Efficiency Rules (Monolith - tier: full)
+
+Codex agent: follow these token-efficiency rules for all output in this repository unless instructed otherwise.
+
+_Answer directly and densely. Use the fewest tokens that fully convey the answer._
+
+- Do not open with greetings, acknowledgements, or filler such as "Sure!", "Great question!", or "Certainly".
+- Do not end with pleasantries or offers of further help such as "I hope this helps!" or "Let me know if you need anything else."
+- Do not restate or paraphrase the request before answering.
+- Correct mistakes in one short sentence; do not apologize repeatedly.
+- Lead with the answer or the result; put caveats and context after, and only if they matter.
+- Do not append a summary of what you just did unless explicitly asked.
+- Prefer dense formats — tables, lists, and code blocks — over prose when they convey the same information in fewer tokens.
+- Do not narrate or re-explain code you just wrote unless asked; let the code and concise comments speak.
+- Write only comments that add non-obvious information; skip comments that merely restate the code.
+- Implement what was asked. Do not add speculative abstractions, options, or defensive code that was not requested.
+- Do not agree reflexively. If something is wrong or a better option exists, say so plainly and briefly.
+
+> User instructions in the conversation always override these rules.
+<!-- monolith:end -->

monolith_ai-0.1.9/CHANGELOG.md

@@ -0,0 +1,129 @@
+# Changelog
+
+All notable changes to this project are documented here. The format is based on
+[Keep a Changelog](https://keepachangelog.com/), and this project adheres to
+[Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.1.9] - 2026-06-02
+
+### Fixed
+- **Packaging**: use PEP 639 SPDX license metadata (`license = "MIT"` +
+  `license-files`); the built sdist/wheel now pass `twine check` and are valid
+  for PyPI.
+- **Publishing actually triggers**: moved PyPI publish into the `release` job of
+  `ci.yml`. A tag pushed by `GITHUB_TOKEN` does not trigger separate workflows,
+  so the old `publish.yml` never ran; publishing now happens in the job that
+  creates the tag. Removed `publish.yml`.
+
+## [0.1.8] - 2026-06-01
+
+### Changed
+- Lint compressor now compacts diagnostics — keeps location + level + rule,
+  drops the verbose human message and repeated file paths. Measured ~49–55%
+  reduction (was ~1%); full detail still tee'd on failure.
+- Removed "inspired by" attributions from the docs and code comments.
+
+## [0.1.7] - 2026-06-01
+
+### Added
+- More command-aware compressors for `run`: linters/type-checkers
+  (eslint/tsc/ruff/flake8/pylint/mypy/biome/stylelint), `git status` (drops the
+  "(use …)" hint chatter), and grep/find (group matches by file, paths by
+  directory; never expands).
+
+## [0.1.6] - 2026-06-01
+
+### Added
+- `monolith run -- <command>` (`runner.py`): runs a command, prints its
+  compressed output, propagates the exit code, and saves full output to
+  `.monolith/tee/` on failure.
+- Command-aware compression (`compressors.py`): `run` recognises test commands
+  (pytest/jest/vitest/go test/cargo test/unittest/npm test) and keeps only
+  failures + the summary (~90% reduction on large runs), falling back to generic
+  `shrink` for unrecognised commands.
+- `monolith gain`: cumulative token-savings ledger across `run` invocations.
+
+## [0.1.5] - 2026-06-01
+
+### Added
+- `SECURITY.md` (disclosure policy + security model and considerations).
+- `docs/PUBLISHING.md`; PyPI publish workflow switched to Trusted Publishing
+  (OIDC) — no stored API token.
+- More hub resources: `test-plan`, `tighten-prose`, `explain-diff`.
+- v0.2.0 plan in `ROADMAP.md`.
+
+## [0.1.4] - 2026-06-01
+
+### Fixed
+- CLI no longer prints a `BrokenPipeError` traceback when its output is piped
+  into a consumer that closes early (e.g. `monolith shrink … | head`). (The fix
+  missed the v0.1.3 tag due to a merge-ordering race; this release carries it.)
+
+## [0.1.3] - 2026-06-01
+
+### Added
+- `monolith scan [--apply]`: scan the repo for inline `@monolith:task` and
+  `@monolith:rule` tags and fold them into the task store / custom rules.
+- `docs/CAPABILITIES.md` (Capability × Monolith table) and `docs/ABOUT.md`
+  (suggested GitHub About / topics).
+- Claude Code guide: install steps, installing hub commands as slash commands,
+  and adding the `shrink` MCP server.
+
+### Removed
+- `monolith compare` command and the README competitor-comparison section.
+  Monolith is now presented on its own capabilities; honest projected-vs-measured
+  framing is kept.
+
+## [0.1.2] - 2026-06-01
+
+### Fixed
+- `--version` now reads from installed package metadata (single-sourced), fixing
+  a drift where it reported the previous version.
+
+### Added
+- Monolith now manages its own repository (dogfooding): generated `CLAUDE.md`,
+  `AGENTS.md`, and `.github/copilot-instructions.md`.
+
+## [0.1.1] - 2026-06-01
+
+### Added
+- PyPI publish workflow (`.github/workflows/publish.yml`) triggered on `v*` tags.
+- Contributor docs: `CONTRIBUTING.md`, issue/PR templates, and a demo script
+  (`scripts/demo.sh`).
+- Launch copy pack under `docs/launch/`.
+
+### Changed
+- README install now leads with `pipx`/`pip` and links the changelog,
+  contributing guide, and demo.
+
+## [0.1.0] - 2026-06-01
+
+### Added
+- **Cross-agent token efficiency**: one directive set compiled into `CLAUDE.md`,
+  `AGENTS.md`, and `.github/copilot-instructions.md`, with `lite`/`full`/`ultra`
+  compression tiers. Commands: `init`, `apply`, `tier`, `doctor`.
+- **Measurement**: `bench` (real reduction on a sample corpus), `stats`
+  (projected + measured), and `compare` (provenance-tagged vs caveman /
+  token-efficient). Optional `tiktoken` extra for exact counts.
+- **Custom rules**: `rules list/add/remove`.
+- **Task management**: `plan` (PRD/Markdown → task tree), `tasks`, and `task`
+  with `{#slug}` / `@after:` dependencies and a generated `TASKS.md`.
+- **Resource hub**: `hub list/search/show/install` of curated agent assets.
+- **Runtime compression**: `shrink` (deterministic) and an experimental MCP
+  server (`mcp`).
+- CI with test matrix (Python 3.9/3.11/3.12) and auto-tagging on merge to
+  `master`.
+
+[Unreleased]: https://github.com/keyurpatel446/Monolith/compare/v0.1.9...HEAD
+[0.1.9]: https://github.com/keyurpatel446/Monolith/compare/v0.1.8...v0.1.9
+[0.1.8]: https://github.com/keyurpatel446/Monolith/compare/v0.1.7...v0.1.8
+[0.1.7]: https://github.com/keyurpatel446/Monolith/compare/v0.1.6...v0.1.7
+[0.1.6]: https://github.com/keyurpatel446/Monolith/compare/v0.1.5...v0.1.6
+[0.1.5]: https://github.com/keyurpatel446/Monolith/compare/v0.1.4...v0.1.5
+[0.1.4]: https://github.com/keyurpatel446/Monolith/compare/v0.1.3...v0.1.4
+[0.1.3]: https://github.com/keyurpatel446/Monolith/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/keyurpatel446/Monolith/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/keyurpatel446/Monolith/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/keyurpatel446/Monolith/releases/tag/v0.1.0

monolith_ai-0.1.9/CLAUDE.md

@@ -0,0 +1,22 @@
+<!-- monolith:start -->
+<!-- Generated by Monolith. Do not edit between the markers; run `monolith apply` to regenerate. -->
+## Token-Efficiency Rules (Monolith - tier: full)
+
+Claude Code: these project rules reduce token usage. Honour them in every response unless the user says otherwise.
+
+_Answer directly and densely. Use the fewest tokens that fully convey the answer._
+
+- Do not open with greetings, acknowledgements, or filler such as "Sure!", "Great question!", or "Certainly".
+- Do not end with pleasantries or offers of further help such as "I hope this helps!" or "Let me know if you need anything else."
+- Do not restate or paraphrase the request before answering.
+- Correct mistakes in one short sentence; do not apologize repeatedly.
+- Lead with the answer or the result; put caveats and context after, and only if they matter.
+- Do not append a summary of what you just did unless explicitly asked.
+- Prefer dense formats — tables, lists, and code blocks — over prose when they convey the same information in fewer tokens.
+- Do not narrate or re-explain code you just wrote unless asked; let the code and concise comments speak.
+- Write only comments that add non-obvious information; skip comments that merely restate the code.
+- Implement what was asked. Do not add speculative abstractions, options, or defensive code that was not requested.
+- Do not agree reflexively. If something is wrong or a better option exists, say so plainly and briefly.
+
+> User instructions in the conversation always override these rules.
+<!-- monolith:end -->

monolith_ai-0.1.9/CONTRIBUTING.md

@@ -0,0 +1,42 @@
+# Contributing to Monolith
+
+Thanks for your interest! Monolith aims to stay small, honest, and dependency-free.
+
+## Development setup
+
+```bash
+git clone https://github.com/keyurpatel446/Monolith
+cd Monolith
+pip install -e .            # or: pip install -e ".[bench]" for exact token counts
+python -m unittest discover -s tests -v
+```
+
+The core is **stdlib-only** by design; please don't add runtime dependencies
+without discussion (`tiktoken` is an optional `[bench]` extra).
+
+## Branching model
+
+| Branch | Purpose |
+|--------|---------|
+| `master` | Default / release branch (merges trigger a tagged release). |
+| `develop` | Integration branch. |
+| `fetcher/<name>` | Feature work. |
+| `fix/<name>` | Bug fixes. |
+
+Open PRs against `develop`. Releases flow `develop → master`.
+
+## Guidelines
+
+- **Tests**: add/extend `unittest` tests under `tests/` for any behaviour change.
+- **Comments**: match the surrounding style — module/function docstrings and
+  rationale for non-obvious logic.
+- **Honesty**: keep projected vs measured numbers clearly labelled; never
+  overstate reductions.
+- **Adding an agent**: subclass `Compiler` in `src/monolith/adapters/`, set
+  `key`/`label`/`target_path`, override `preamble()`, decorate with `@register`,
+  and add it to the import list in `adapters/__init__.py`.
+
+## Releasing
+
+Bump `version` in `pyproject.toml`, update `CHANGELOG.md`, and merge to `master`.
+CI tags `vX.Y.Z`, creates a GitHub release, and publishes to PyPI.

monolith_ai-0.1.9/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Keyur Patel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

monolith_ai-0.1.9/PKG-INFO

@@ -0,0 +1,211 @@
+Metadata-Version: 2.4
+Name: monolith-ai
+Version: 0.1.9
+Summary: Cross-agent token-efficiency layer for AI coding assistants (Claude Code, OpenAI Codex, GitHub Copilot).
+Project-URL: Homepage, https://github.com/keyurpatel446/monolith
+Project-URL: Roadmap, https://github.com/keyurpatel446/monolith/blob/main/ROADMAP.md
+Author-email: Keyur Patel <keyurpatel446@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agents,claude-code,cli,codex,copilot,llm,tokens
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Provides-Extra: bench
+Requires-Dist: tiktoken>=0.5; extra == 'bench'
+Description-Content-Type: text/markdown
+
+# 🧱 Monolith
+
+> **One ruleset. Every agent. Fewer tokens.**
+
+[![CI](https://github.com/keyurpatel446/Monolith/actions/workflows/ci.yml/badge.svg)](https://github.com/keyurpatel446/Monolith/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](pyproject.toml)
+[![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](#-development--branching)
+[![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-PayPal-00457C?logo=paypal&logoColor=white)](https://paypal.me/keyurpatel446)
+
+**Reduce token usage across Claude Code, OpenAI Codex, and GitHub Copilot from one
+config.** Monolith is a small, dependency-free CLI that writes proven token-saving
+rules into the native instructions file each AI coding agent already reads — so
+you author the rules **once** and every agent obeys them:
+
+| Agent | File Monolith generates |
+|-------|-------------------------|
+| Claude Code | `CLAUDE.md` |
+| OpenAI Codex | `AGENTS.md` |
+| GitHub Copilot | `.github/copilot-instructions.md` |
+
+It also does **task management** (PRD → tracked tasks), ships a **resource hub**
+of installable agent commands, and can **`shrink`** verbose tool output at
+runtime — all from one tool.
+
+---
+
+## ⚡ Before / After
+
+**Without Monolith** — _84 tokens_
+> Great question! I'd be happy to help you figure this out. So, the reason your
+> function is returning `None` is actually because there's no explicit return
+> statement at the end of the branch. What you'll want to do here is make sure
+> you return the computed value. I hope this helps, and let me know if you have
+> any other questions!
+
+**With Monolith** — _19 tokens (−77%)_
+> It returns `None` because that branch has no return. Return the computed value.
+
+Same answer. ~⅕ the tokens. (Measured by `monolith bench`.)
+
+---
+
+## 🪄 Why
+
+Each agent reads instructions from a different file, so today you'd copy-paste
+the same rules into three places and keep them in sync by hand. Monolith keeps
+one canonical source and compiles it. Re-running is safe: managed content lives
+between markers and never clobbers your own notes in the same file.
+
+It unifies what used to take several separate tools into one cross-agent CLI:
+token-saving rules, dense-output tiers, task management, a resource hub, and
+runtime command-output compression.
+
+## 📦 Install
+
+Requires Python ≥ 3.9. Dependency-free core.
+
+```bash
+pipx install monolith-ai      # recommended (isolated)
+# or
+pip install monolith-ai
+```
+
+From source (current default until the first PyPI release is published):
+
+```bash
+git clone https://github.com/keyurpatel446/Monolith && cd Monolith
+pip install -e .              # or: pip install -e ".[bench]" for exact token counts
+```
+
+## 🚀 Quickstart
+
+```bash
+monolith init                 # detect agents, create .monolith/settings.json
+monolith apply --agent all    # write CLAUDE.md, AGENTS.md, copilot-instructions.md
+monolith doctor               # verify each agent picked up the rules
+monolith tier ultra --apply   # crank up compression
+monolith bench                # measure real token reduction on the sample corpus
+```
+
+## 🧰 What you get
+
+**Token efficiency**
+
+| Command | Description |
+|---------|-------------|
+| `monolith init` | Detect agent files and create `.monolith/settings.json`. |
+| `monolith apply [--agent all\|claude\|codex\|copilot\|config]` | Compile the directives into agent configs (idempotent). |
+| `monolith tier [name] [--apply]` | Show or switch the active compression tier. |
+| `monolith stats` | Show projected reduction, last measured reduction, and the input cost of the block. |
+| `monolith bench` | Run the built-in benchmark corpus and record measured token reduction. |
+| `monolith rules list\|add\|remove [value]` | Manage custom directives appended to every block. |
+| `monolith doctor` | Verify each configured agent has the Monolith block. |
+
+**Task management**
+
+| Command | Description |
+|---------|-------------|
+| `monolith plan <prd-file> [--force]` | Parse a PRD/Markdown file into a task tree; writes `TASKS.md`. |
+| `monolith tasks [--emit]` | List the task tree; `--emit` re-writes `TASKS.md`. |
+| `monolith task <id> --status todo\|doing\|done` | Update a task's status (warns on unmet dependencies). |
+
+**Resource hub & runtime**
+
+| Command | Description |
+|---------|-------------|
+| `monolith hub list\|search <q>\|show <id>\|install <id> [--agent]` | Browse and install curated agent resources. |
+| `monolith shrink [file] [--level lite\|full\|ultra]` | Compress verbose output (stdin or file) deterministically. |
+| `monolith run -- <command>` | Run a command, compress its output, save full output to disk on failure. |
+| `monolith gain` | Show cumulative token savings from `run`. |
+| `monolith mcp` | Run the experimental MCP server exposing `shrink` over stdio. |
+| `monolith scan [--apply]` | Scan the repo for `@monolith:` task/rule tags and apply them. |
+
+Global flag `--root <dir>` runs against another project directory.
+
+## 🎚️ Tiers
+
+| Tier | Intensity | Projected output reduction* |
+|------|-----------|-----------------------------|
+| `lite` | filler removal only | ~25–35% |
+| `full` (default) | filler + dense formatting + no over-engineering | ~55–65% |
+| `ultra` | telegraphic, bullet-first, every directive | ~60–70% |
+
+\* Projections derived from upstream benchmarks, not per-project measurements.
+Run `monolith bench` for a figure measured on the sample corpus.
+
+See [docs/CAPABILITIES.md](docs/CAPABILITIES.md) for the full capability list.
+
+## 🗂️ Task management
+
+Point `monolith plan` at a PRD or any structured Markdown file. Headings and
+list items become tasks; nesting becomes parent/child. Wire up dependencies
+with inline tags — `{#slug}` names a task and `@after:slug` depends on it:
+
+```markdown
+# Auth feature
+- Design DB schema {#schema}
+- Build API @after:schema
+  - Add input validation
+## Release @after:schema
+```
+
+`monolith plan prd.md` writes a shared task store under `.monolith/tasks/` and a
+root `TASKS.md` your agents read as ordinary project context.
+
+## 📚 Documentation
+
+- [Usage guide](docs/USAGE.md) · [Capabilities](docs/CAPABILITIES.md)
+- Per-agent setup: [Claude Code](docs/agents/claude-code.md) ·
+  [Codex](docs/agents/codex.md) · [Copilot](docs/agents/copilot.md)
+- [Roadmap](ROADMAP.md) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md)
+- [Security](SECURITY.md) · [Publishing](docs/PUBLISHING.md)
+- [Analysis](docs/analysis/) — benchmarks, competitor & stability analysis
+- Demo: run `bash scripts/demo.sh` (record with asciinema)
+
+---
+
+<sub>Keywords: reduce Claude Code token usage · Codex `AGENTS.md` token efficiency ·
+GitHub Copilot instructions to save tokens · compress AI command/test output for
+LLMs · cross-agent token optimization CLI · one config for Claude Code, Codex and
+Copilot.</sub>
+
+## 🌱 Development & branching
+
+| Branch | Purpose |
+|--------|---------|
+| `master` | Default / release branch. Merges here trigger CI to tag a release. |
+| `develop` | Integration branch for completed features. |
+| `fetcher/<name>` | Feature work. |
+| `fix/<name>` | Bug fixes. |
+
+CI ([`.github/workflows/ci.yml`](.github/workflows/ci.yml)) runs the test suite
+on every push/PR to `master` and `develop`. When code is merged to `master`, it
+reads the version from `pyproject.toml` and, if a matching tag does not yet
+exist, creates the tag `vX.Y.Z` and a GitHub release. Bump `version` in
+`pyproject.toml` to cut a new release.
+
+```bash
+python -m unittest discover -s tests -v   # run the tests locally
+```
+
+## ☕ Support
+
+Monolith is free and MIT-licensed. If it saves you tokens (and money), consider
+chipping in for a coffee — it genuinely helps keep the project moving. 🙏
+
+[![Buy me a coffee via PayPal](https://img.shields.io/badge/☕%20Buy%20me%20a%20coffee-PayPal-00457C?logo=paypal&logoColor=white&style=for-the-badge)](https://paypal.me/keyurpatel446)
+
+> 👉 **[paypal.me/keyurpatel446](https://paypal.me/keyurpatel446)**
+
+## 📄 License
+
+MIT © Keyur Patel