Learn & Workflows
Discover how to master Uneven Agent for daily software engineering workflows.
1. The Conversational Shell
Typing uneven in any terminal launches your conversational workspace assistant. Uneven automatically understands your repository structure and provides context-grounded answers.
Natural Dialogue in Any Language
You can talk naturally in your native language (e.g. Portuguese or English). Uneven explains concepts, plans refactors, and synthesizes code explanations while keeping your diffs and code syntax cleanly formatted.
Essential Slash Commands
Inside the interactive shell, quick slash commands allow you to configure behavior without leaving your flow:
/models # switch between local offline models and cloud providers /go # immediately approve and apply a proposed plan to disk /fix # configure terminal watch preferences and auto-fix rules /effort # configure reasoning effort (low, medium, high) /skills # activate dynamic operational engineering standards
2. Deep Reasoning & Pre-Flight Simulation
Senior software engineering requires thinking before writing. Uneven incorporates a multi-stage reflection loop to audit proposed changes before touching any file:
- Draft Assumption Unpacking: Scrutinizes implicit assumptions, edge cases, and architectural fragility.
- Pre-Flight Execution Simulation: Mentally walks through the code execution trace, checking imports, type contracts, and side-effects.
- Architectural Audit: Evaluates the solution against complexity limits, backward compatibility, and domain boundaries.
This reflection guarantees that solutions are clean, robust, and free from logic drift.
3. Uneven Pods: Layered Engineering
For larger codebases, Uneven organizes engineering work into dedicated, persistent architectural clusters called Pods:
Database Pod ──► Backend Pod ──► Frontend Pod ──► DevOps Pod
Each Pod owns a vertical slice of your stack under strict domain isolation:
- Domain Boundaries: The Database Pod modifies schemas and migrations, but cannot randomly rewrite UI components.
- Contract Handoffs: When a Pod finishes a task, it automatically emits a structured summary of public contracts (endpoints, types, DTOs) for sibling layers to consume.
- Orchestrated Delivery: The Master Agent coordinates dependencies across layers automatically.
4. Smart & Safe Code Editing
Uneven automatically scales its response strategy based on task complexity:
- Conceptual Inquiries: Direct explanations in clean Markdown without unnecessary file edits.
- Atomic Single-File Fixes: Immediate, surgical search/replace patches presented for your quick approval.
- Complex Multi-File Features: Comprehensive architectural blueprint first, outlining affected files and contracts before generating large diffs.
- Reactive Approval: Confirming naturally with "sim", "apply", or
/goapplies the changes directly to disk.
5. Terminal Watcher & Autonomous Fixes
Uneven can monitor running dev processes in the background (e.g. your dev server, test suites, or compilers).
- Captures stdout and stderr in real time with zero idle CPU overhead.
- Parses stack traces with exact file, line, and column accuracy across all popular languages.
- Proposes surgical, minimal fixes based on your real codebase context so you never lose debugging momentum.