This guide will get you up and running with Plexus in just a few minutes.

Step 1: Launch Plexus

Open Plexus from your Applications folder (macOS), Start Menu (Windows), or application launcher (Linux).

On first launch, Plexus will automatically install hooks for Claude Code, Cursor, and Gemini CLI.

Step 2: Start Your AI Agents

Open a terminal and start using your AI agents as normal:

# Start Claude Code
claude

# Or start Gemini CLI
gemini

# Cursor works automatically when you open the IDE

Within seconds, the agent will appear in the Plexus dashboard.

Step 3: The Dashboard

The Plexus dashboard shows all your active AI agent sessions:

Session Cards

Each active session is displayed as a card showing:

Agent Type - Claude Code, Cursor, or Gemini CLI
Status - Current state of the agent
Project - Working directory and git branch
Cost - Token usage and estimated API cost

Status Indicators

Status	Color	Meaning
Active	Green	Agent is generating a response
Waiting	Yellow	Agent is waiting for your input
Idle	Gray	Agent is idle, no activity

Step 4: Focus Terminal

When an agent needs your attention, click on its card or use the Focus Terminal feature to jump directly to that terminal window.

This is especially useful when you have multiple agents running across different terminals.

Plexus is designed for keyboard-first interaction. Press ? to see all available shortcuts.

Essential Shortcuts

Shortcut	Action
`J` / `K`	Navigate up/down in lists
`Esc`	Close panel / Cancel
`?`	Show keyboard shortcuts

Step 6: View History

Click on a session card or use the sidebar to access:

Session Transcript - Full conversation with the agent
Cost Breakdown - Token usage by message

Search History

Use the search feature to find past conversations:

Click the History tab in the sidebar
Enter keywords to search
Filter by agent type, date, or project
Click a result to view the full session

Step 7: Configure Notifications (Optional)

Set up webhook notifications to get alerts in Slack or Discord when agents need your attention.

Open Settings
Go to Integrations
Add your Slack or Discord webhook URL
Choose which events to notify

Key Concepts

Sessions

A session is a single conversation with an AI agent. Each time you start a new conversation (e.g., run claude in a new terminal), Plexus creates a new session.

Projects

Plexus automatically detects the project you're working in based on:

Current working directory
Git repository root
Git branch name

Sessions are grouped by project for easy filtering.

Cost Tracking

Plexus tracks API costs by:

Monitoring token usage (input and output tokens)
Calculating costs based on current model pricing
Aggregating costs by session, day, and project

Common Workflows

Monitoring Multiple Agents

Open multiple terminals
Start different AI agents in each
Use Plexus dashboard to see all sessions at once
Click on any session to see details or jump to terminal

Finding Past Conversations

Go to History in the sidebar
Search for keywords or filter by date
Click a session to view the full transcript

Troubleshooting

Agent Not Appearing

If an AI agent doesn't appear in Plexus:

Make sure Plexus is running
Restart the AI agent (exit and start again)
Check that hooks are installed in Settings

Next Steps

Explore the Introduction for a deeper understanding
Configure Discord/Slack Notifications for team workflows

Quick Start