Geoff Code is a general-purpose terminal agent. You describe a goal in natural language; it reads the relevant code, plans, edits, runs commands, and verifies the result — pausing for your approval on anything that touches your files or shell. Below are the patterns it handles best.

Implement a new feature

Geoff Code follows a Read → Edit → Verify loop: it explores the relevant code, understands the structure, makes the change, then runs your tests or build to confirm it works.
Refine iteratively by pointing at a reference:

Fix a bug

Give Geoff Code a description, an error log, or a command that reproduces the problem. It locates the root cause, applies a fix, and re-runs the reproduction to confirm.

Understand a codebase

Drop into an unfamiliar repo and ask architectural questions. Geoff Code traces implementations, explains file purposes, and maps data flow without changing anything.
Run /init once on a new repo to generate an AGENTS.md summary that speeds up every later run.

Automate small coding tasks

Repetitive edits across many files are a sweet spot — exactly the kind of work that’s tedious by hand.

Automate general tasks

Geoff Code isn’t limited to code. Because it has shell access, it can handle research, log analysis, and batch file work.

Run it in scripts and CI

For unattended work, use non-interactive mode. Combine -p with -y (auto-approve) so the agent doesn’t block waiting for confirmation:
For machine-readable output in a pipeline, request streaming JSON:
-y (yolo) auto-approves every action including file writes and shell commands. Only use it in trusted, sandboxed, or disposable environments.

Keep going

Sessions

Resume long-running work and manage conversation context.

Skills

Teach Geoff Code your team’s conventions and workflows.

Hooks

Auto-format, validate, and gate the agent’s actions.

Agents

Delegate to specialized subagents with isolated context.