# AGENTS.md

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

## Setup

```
pnpm install
```

## Commands

```
pnpm test           # run the test suite, must pass before any commit
pnpm test:windows
```

## Layout

- `proxy/`       246 source files
- `packages/`    222 source files
- `engine/`      149 source files
- `shared/`      71 source files
- `tests/`       38 source files
- `cacheengine/` 34 source files

## Conventions

- Tests live alongside the code they cover, following `agents/delegate/portable-process.test.mjs`.
- CI defines what passing means. See `.github/workflows/ci.yml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

## Gotchas

- Generated output is committed (`dist/`). Search will return the compiled copy, so edit the source, not that.
- `packages/cli/src/index.ts` is 709KB. It will not fit comfortably in context, so read it in parts.

---

Drafted by agentreadme.com from what is in this repository. Everything marked TODO
needs a human. Check it in as AGENTS.md at the root.