# AGENTS.md

Your Personal AI super intelligence. A brain that builds a local-first memory of your life, a fantastic orchestrator of agent fleets and workflows, and a deep researcher.

## Setup

```
pnpm install
```

## Commands

```
pnpm dev             # run locally
pnpm build           # produce a build
pnpm test            # run the test suite, must pass before any commit
pnpm typecheck       # type check without emitting
pnpm lint            # lint
pnpm format          # format
pnpm docs:generate
pnpm docs:check
```

## Layout

- `app/`      2082 source files
- `src/`      1866 source files
- `scripts/`  220 source files
- `tests/`    130 source files
- `packages/` 18 source files
- `e2e/`      8 source files

## Conventions

- Tests live alongside the code they cover, following `app/scripts/e2e-run-spec.sh`.
- CI defines what passing means. See `.github/workflows/android-compile.yml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

## Gotchas

- `app/src/lib/i18n/bn.ts` is 667KB. 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.