# AGENTS.md

open-source coding agent

## Setup

```
npm ci
```

## Commands

```
npm run format             # format
npm run tsc:watch
npm run tsc:watch:gui
npm run tsc:watch:vscode
npm run tsc:watch:core
npm run tsc:watch:binary
npm run format:check
npm run prepare
```

## Layout

- `extensions/`             637 source files
- `core/`                   617 source files
- `gui/`                    374 source files
- `packages/`               249 source files
- `manual-testing-sandbox/` 37 source files
- `docs-site/`              34 source files

## Conventions

- Tests live alongside the code they cover, following `.continue/prompts/core-unit-test.prompt`.
- TypeScript is not in strict mode. Turning it on catches a whole class of mistakes before they run.
- CI defines what passing means. See `.github/workflows/auto-assign-issue.yaml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

## Gotchas

- `core/llm/llamaTokenizer.js` is 656KB. 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.