# GEMINI.md

This file provides guidance to Gemini CLI when working with code in this repository.

Start with [AGENTS.md](AGENTS.md) for the shared repository rules. Use [CLAUDE.md](CLAUDE.md) for the deeper architecture and development walkthrough; it remains the most complete agent-specific guide in this repo.

## Quick Working Rules

- Edit source files in `core/src/`, `server/src/`, `cli/src/`, and `gui-v2/src/`; avoid changing generated `dist/` output.
- Match nearby TypeScript style: 2 spaces, semicolons, single quotes, explicit `.js` import suffixes in source.
- Add focused colocated tests for bug fixes, especially around adapters, routing, terminal/session behavior, and hooks.
- Prefer `rg` / `rg --files` for search.

## Key Commands

```bash
npm install
npm run build:all
npm run start:server
npm run dev:gui
npm run test:core
npm test
```

## Multi-Agent Notes

- Adapter definitions live in `core/src/adapters/`.
- Terminal/session integration lives mostly in `server/src/handlers/` and `server/src/terminal/`.
- The current adapter reference is `docs/ADAPTERS.md`.
- Terminal rendering behavior per tool is documented in `docs/TERMINAL-DISPLAY.md`.