Agents

When you want CodexaX to do real work, not just answer questions.

What's an agent?

An agent plans, then executes. Multi-file edits, runs commands, reads docs, asks for clarification — all with a human-in-the-loop diff for every change.

Two modes

Edit mode — focused, multi-file changes. You describe the outcome, agent ships a diff.
Plan mode — agent first writes a plan you approve, then executes step by step.

How a session looks

> Add OTP login backed by my API.

  Plan
  ───────
  1. Create src/auth/otp.ts (request + verify functions)
  2. Add /api/otp/request and /api/otp/verify routes
  3. Wire to existing JWT helper in src/auth/jwt.ts
  4. Add LoginForm component with phone → code flow

  Approve plan? [y/N]

Stopping & guardrails

Every shell command needs your approval (or you opt-in to auto-allow specific commands).
Every file write shows a diff before applying.
Esc cancels mid-step.
The agent never installs packages or pushes to git without explicit approval.