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
- Navigate to the Agent page in the dashboard
- Select a repository and branch from the dropdown
- Choose a model (Max, Mid, or Fast)
- 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
- Questions — The agent may ask clarifying questions before proceeding
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 complex tasks, the agent may produce 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
- Send a message to provide additional context
Reviewing Results
Diff Panel
When the agent modifies code, a side panel shows file-by-file diffs with additions and deletions. Click any file to see the full diff.
Pull Requests
If the agent creates a PR, a link appears in the session header. 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 (running, completed, stopped, failed)
- Number of files changed
Team members can see each other's sessions.
Stopping a Session
Click the Stop button to halt a running session at any time. The agent stops execution and saves its progress. You can resume by sending a follow-up message.