# AGENTS.md

omo/lazycodex: The coding agent for tokenmaxxers;the one and only agent harness for complex codebases. For your Codex, for your OpenCode

## Setup

```
bun install
```

## Commands

```
bun build                 # produce a build
bun test                  # run the test suite, must pass before any commit
bun typecheck             # type check without emitting
bun build:cli-node
bun build:codex-install
bun install:codex-dev
bun build:codex-plugin
bun build:senpi-plugin
```

## Layout

- `packages/`     6037 source files
- `script/`       105 source files
- `tests/`        11 source files
- `bin/`          7 source files
- `scripts/`      3 source files
- `test-support/` 1 source file

## Conventions

- Tests live alongside the code they cover, following `.agents/skills/codex-qa/scripts/lib/app-server-client.test.js`.
- TypeScript runs in strict mode. Type errors are the fastest feedback available, so do not weaken it.
- 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

- `packages/omo-senpi/plugin/extensions/omo.js` is 851KB. It will not fit comfortably in context, so read it in parts.
- Copy `.env.example` before running anything that needs configuration.

---

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.