Sessions

Create agent sessions, interact with the agent in real time, and review fixes and test changes.

A session is a single conversation with the Paragon Agent. Each session works on one repository and branch, processes your prompt, and produces code changes — bug fixes, new tests, or quality improvements.

Creating a Session

1. Navigate to the Agent page in the dashboard
2. Select a repository and branch from the dropdown
3. Choose a model (Max, Mid, or Fast)
4. Type your prompt and send

You can attach images to your prompt for additional context (screenshots of bugs, error logs, test failures).

Interacting with a Session

Real-Time Streaming

As the agent works, you see its progress in real time:

• Thinking — The agent's reasoning process (collapsible)
• Tool calls — Commands run, files read, searches performed
• Files changed — Live diff counts as files are modified
• Parallel agents — When workers are spawned, see each agent's current activity and status

Questions

The agent may ask clarifying questions before proceeding. Questions appear inline with the following types:

• Single select — Pick one option from a list
• Multi select — Pick multiple options
• Text — Free-form answer

Each question can include option descriptions for additional context. You can skip optional questions.

Follow-Up Messages

You can send additional messages to a running session to:

• Provide clarification the agent asked for
• Redirect the agent's approach
• Add requirements you forgot to mention

Completed, stopped, or failed sessions can also be resumed with follow-up messages.

Plan Approval

For Grind mode sessions, the agent produces a plan before making changes. When this happens:

• The session enters an awaiting plan approval state
• Review the proposed plan with phases and subtasks
• Approve to let the agent proceed with execution
• Reject to have the agent revise its approach (you can request revisions multiple times)
• Send a message with additional context or corrections

Toggle between manual approval and auto-accept mode using the plan approval toggle in the input bar.

Session Statuses

Reviewing Results

Diff Panel

When the agent modifies code, a side panel shows file-by-file diffs with syntax highlighting. Each file displays:

• File path
• Lines added and removed
• Full diff with additions and deletions highlighted

Click any file to see its complete diff.

Pull Requests

If the agent creates a PR, a link appears in the session header with the PR status (open, merged, closed). Click it to go directly to the GitHub pull request.

Session History

All sessions are listed in the sidebar, grouped by date. Each shows:

• Repository and branch
• Status indicator
• Number of files changed

Team members can see each other's sessions.

Stopping a Session

Click the Stop button to halt a running session or cancel a plan approval wait. The agent stops execution and saves its progress. You can resume by sending a follow-up message.