Agent overview
The agent is the core of 4RGE. You describe what you want in natural language; the agent gathers context from your codebase, runs tools, and edits files — pausing for your approval at the moments that matter.
Whether you are fixing a bug locally, refactoring a service, or delegating a long task to a cloud agent, the same agent loop applies: understand the request, take action through mediated tools, and verify the result before you accept changes.
How Agent works
An agent is built on three components:
- Instructions — The system prompt and rules that guide agent behavior
- Tools — File editing, codebase search, terminal execution, and more. See Tools.
- Model — The agent model you pick for the task. Your org controls availability in Model control.
Checkpoints
Checkpoints save snapshots of your codebase during an agent session. The agent automatically creates them before making significant changes, capturing the state of all modified files.
If the agent takes a wrong turn, click any checkpoint in the chat timeline to preview your files at that point, then restore to revert all files to that state. You can also restore from the Restore Checkpoint button on previous requests or the + button when hovering over a message.
Checkpoints are useful for exploratory work, complex refactoring, and iterative development where you want safe rollback points.
Checkpoints are stored locally and separate from Git. Only use them for undoing agent changes; use Git for permanent version control.
Using the queue
- While the agent is working, type your next instruction
- Press Enter to add it to the queue
- Messages appear in order below the active task
- Drag to reorder queued messages as needed
- The agent processes them sequentially after finishing the current task
Keyboard shortcuts
- Press Enter while the agent is running to queue your next message instead of interrupting the current task
- Press ⌘K (or Ctrl K) to search documentation while you work
- In the agent panel, refer to files with
@filenamewhen your build supports it — the agent prioritizes those paths