termigo: Instructions file for Codex

AGENTS.md

Read TERMIGO.md first. It is the living architecture doc and source of truth. On conflict, TERMIGO.md wins over this file and over docs/.

Project snapshot

Termigo: open-source AI-native terminal emulator. Tauri 2 + Rust (portable-pty) backend in src-tauri/, React 19 + TypeScript + xterm.js client in src/, Go automation companion in cli/. Package manager pnpm only. See TERMIGO.md and docs/README.md for the module map.

Agent Guidelines

1. Operate pragmatically with full tool access (no sandbox, no path boundaries).
2. Agent and subagents are empowered to inspect, edit, build, and test autonomously to achieve the user goal.
3. Retain and support git worktree isolation for branch operations and subagent tasks.
4. Ground every finding and edit in real files and lines: path plus symbol or command name. No hallucinated imports or phantom paths. Cross-check frontend invoke("...") names against Rust generate_handler! via pnpm check:commands.
5. Judge against the quality bar in TERMIGO.md: correctness, performance (light bundle, no redundant IPC or re-renders), security, UI/UX, architecture (functional core, thin shell).

Checks to run for evaluation

pnpm lint
pnpm format:check
pnpm check-types
pnpm check:commands
pnpm check:doc-commands
pnpm test
cd src-tauri && cargo clippy --all-targets --locked -- -D warnings
cd src-tauri && cargo nextest run --locked # fallback: cargo test --locked

Reference: docs/contributing/testing.md and .github/workflows/ci.yml.

Conventions

• No unicode em-dash (—, U+2014) or en-dash (–, U+2013) in prose, comments, commits, or documentation.
• Standard ASCII double-hyphen (--) IS PERMITTED AND REQUIRED for CLI flags (e.g. --version, --build, ssh -- <command>), code operators (--i), and markdown fences. Never confuse ASCII -- with unicode em-dash.
• No emojis anywhere.
• Defer to USER.md for specific user preferences and workflow instructions.