# AGENTS.md

Short guide for AI agents in this repo. Prefer progressive loading: start with the root README, then package READMEs as needed.

## Repo layout
- `cli/` - hapi CLI, daemon, Codex/MCP tooling
- `server/` - Telegram bot + HTTP API + Socket.IO + SSE
- `web/` - React Mini App / PWA

## Reference docs
- `README.md` (user overview)
- `cli/README.md` (CLI behavior and config)
- `server/README.md` (server setup and architecture)
- `web/README.md` (web app behavior and dev workflow)
- `localdocs/` (optional deep dives)

## Shared rules
- TypeScript strict; no untyped code.
- Bun workspaces; run `bun` commands from repo root.
- Path alias `@/*` maps to `./src/*` per package.
- No backward compatibility: breaking format changes are allowed.
- Prefer 4-space indentation.

## Common commands (repo root)
    bun run build
    bun run build:single-exe
    bun run typecheck
    bun run dev:server
    bun run dev:web
    bun run test

## Key source dirs
- `cli/src/api/`, `cli/src/claude/`, `cli/src/commands/`, `cli/src/codex/`
- `server/src/web/`, `server/src/socket/`, `server/src/telegram/`, `server/src/sync/`
- `web/src/components/`, `web/src/api/`, `web/src/hooks/`