ClevAgent

Getting Started

Download the app, sign in, and open your agent workspace.

1

Download the Desktop App

The desktop app is coming soon. Enter your email to get notified when it's ready:

macOS, Windows, and Linux. Code signing is in progress. We'll email you as soon as signed builds are available.
2

Sign In

Open ClevAgent and sign in with your account. You can use Google or email/password.

Don't have an account? Sign up free.

3

You're Ready

After signing in, you'll see your agent dashboard. It's empty for now. Next step: adding your first agent.

Adding Agents

Create an agent pane to start running tasks.

1

Click "Add Agent" in the app.

2

Choose how to connect your agent:

  • Auto-detect: ClevAgent finds running agents on your machine automatically
  • Run command: paste the command you use to start your agent
  • System service: select from services already running on your OS
3

Give your agent a name and click "Start". Real-time session auditing begins immediately.

Tip: Use consistent, unique names for each agent. Typos create duplicate entries.

Health Tracking

ClevAgent tracks your agents while they run. See when they crash, when they recover, and their current status.

Agent Status

StatusMeaning
🟒 HealthyAgent is running normally
πŸ”΅ StartingAgent is launching, waiting for first session connection
πŸ”΄ DeadAgent has stopped or crashed
⏸️ StoppedManually stopped by user

When ClevAgent detects a crash, it automatically attempts to restart your agent. If the restart fails, the event appears in your dashboard history.

Cost Tracking & Saving

Every API call is tracked. See per-agent spending in real time.

  • Per-agent cost dashboard: see spending per hour, per day, and per month. Use dashboard history to review cost thresholds and activity spikes.
  • Cost tracking and saving (Pro): when ClevAgent detects your agent is stuck in a loop or burning tokens on retries, it records dashboard guidance to get back on track. This prevents unnecessary spending before the bill adds up.

Web Dashboard & Settings

Access your data from any browser at clevagent.io/dashboard. Some features are app-only.

FeatureAppWeb
Add & start agentsβœ“β€”
Auto-restart on/offβœ“β€”
Tray icon statusβœ“β€”
Agent status & historyβœ“βœ“
Cost & activity overviewβœ“βœ“
Team membersβ€”βœ“
Billing & plansβ€”βœ“

Plans

See the Pricing page for full details.

FeatureFreePro
Agents13
Health check interval60s15s
Cost trackingβœ“βœ“
Cost savingβ€”βœ“
Dashboard audit historyβœ“βœ“

Server & Headless Environments

Looking to run agents in the cloud? ClevAgent is a native-first workstation app designed for local supervision.

All active development, orchestration, and manual interventions are handled locally inside ClevAgent on your Mac, securing your local workflow while keeping your credentials protected on your own machine.

Troubleshooting

Agent shows "Starting" and never changes

The agent session hasn't started yet. Make sure it's running. It may take up to 60 seconds for the first workspace connection.

Restart keeps failing

Check that the agent's start command is correctly configured. Look at the event log in the dashboard for error details.

Offline behavior

When your machine loses internet, agents continue running and auto-restart still works locally. Session metadata and cost data are buffered and sent automatically when the connection is restored.

Questions? Email [email protected]