Pragma AI Agent

Pragma includes an AI coding agent inside the desktop app. The agent is designed to work where developers already work: terminal, editor, project files, command history, and source control.

Users do not need to understand how Pragma is built internally. They only need to know that the agent can see the working context they choose to share and can help them complete development tasks inside the app.

What The Agent Can Do

The agent can help users:

  • Explain a codebase.
  • Find files and symbols.
  • Write or edit code.
  • Run terminal commands.
  • Diagnose errors.
  • Review diffs.
  • Generate tests.
  • Work with project context.
  • Use configured external tools.

Agent Autonomy

Users should be able to choose how much control the agent has:

ModeBehavior
Ask firstThe agent explains the plan and waits before running commands or editing files
AssistedThe agent can make low-risk edits but asks before larger operations
AutonomousThe agent can execute a longer task with less interruption

For sensitive projects, users should start with ask-first mode.

Context The Agent Uses

The agent can use context from:

  • Open files.
  • Current terminal directory.
  • Recent commands.
  • Project file tree.
  • Search results.
  • Selected text.
  • User instructions.
  • Configured MCP servers.
  • Workspace rules and preferences.

Working With Other Agents

Pragma can also host CLI-based coding agents. Users can run tools such as Codex, Claude Code, Gemini CLI, or their own internal agent from the terminal while still using Pragma's editor, panes, search, Drive, and secrets.

Good User Flow

  1. Open a project.
  2. Ask the agent to inspect the code.
  3. Let it summarize the important files.
  4. Ask for a change.
  5. Review the plan.
  6. Let it edit.
  7. Run tests.
  8. Review the diff.
  9. Commit or discard the result.

Safety

The agent should treat destructive actions carefully. Deleting files, changing credentials, force-pushing, modifying production configuration, or running expensive cloud commands should require clear user approval.