# AGENTS.md

An open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.

## Setup

```
# TODO: the install command. No lockfile was found, so this could not be inferred.
```

## Commands

```
make help
make setup
make doctor
make support-bundle
make detect-blocking-io
make config
```

## Layout

- `backend/`  1215 source files
- `frontend/` 615 source files
- `scripts/`  41 source files
- `skills/`   23 source files
- `docker/`   5 source files
- `tests/`    5 source files

## Conventions

- Tests live alongside the code they cover, following `backend/tests/_agent_e2e_helpers.py`.
- CI defines what passing means. See `.github/workflows/backend-blocking-io-tests.yml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

## Gotchas

- `backend/tests/test_channels.py` is 402KB. It will not fit comfortably in context, so read it in parts.
- Copy `.env.example` before running anything that needs configuration.
- No lockfile is committed, so an install here may not match what CI produced.

---

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.