ClevAgent is in Early Access. Please contact us if you have any questions!
ClevAgent

Getting Started

Download the app, sign in, and start monitoring your agents.

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

Register an agent to start monitoring it.

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". Monitoring begins immediately.

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

Health Tracking

ClevAgent monitors your agents around the clock. Know when they crash, when they recover, and their current status.

Agent Status

StatusMeaning
🟒 HealthyAgent is running normally
πŸ”΅ StartingAgent is launching, waiting for first heartbeat
πŸ”΄ 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, you receive an alert.

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. Set cost limits and get alerts when thresholds are exceeded.
  • Cost tracking and saving (Pro): when ClevAgent detects your agent is stuck in a loop or burning tokens on retries, it sends a reminder to get back on track. This prevents unnecessary spending before the bill adds up.

Notifications

Get notified when your agent crashes, gets stuck, or exceeds cost limits.

ChannelType
TelegramReal-time alerts (crash, loop, cost)
EmailDaily audit report (6:00 AM UTC)

Setting Up Telegram

Configure from the Alerts sub-tab.

  1. Create a bot: message @BotFather on Telegram, run /newbot, copy the token.
  2. Connect: Dashboard β†’ Settings β†’ Telegram Alerts. Paste the bot token + your Chat ID.
  3. Test: Click Send Test to verify.
Finding your Chat ID: Start a chat with your bot, then visit https://api.telegram.org/bot<TOKEN>/getUpdates. The chat.id field is your Chat ID.

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βœ“βœ“
Notification settingsβœ“βœ“
Telegram setupβ€”βœ“
Team membersβ€”βœ“
Billing & plansβ€”βœ“

Plans

See the Pricing page for full details.

FeatureFreePro
Agents13
Health check interval60s15s
Cost trackingβœ“βœ“
Cost savingβ€”βœ“
Telegram alertsβœ“βœ“
Daily email reportβœ“βœ“

Server & Headless Environments

Running agents on a server without a desktop? Use the Installer instead of the app.

1

Go to Dashboard β†’ Add Agent and select your server platform.

2

Download the generated installer. It includes your API key and agent configuration.

3

Run the installer on your server. Monitoring starts automatically.

Need help with server setup? Contact [email protected].

Troubleshooting

Agent shows "Starting" and never changes

The agent hasn't sent its first heartbeat yet. Make sure it's running and connected to the internet. It may take up to 60 seconds for the first check.

Not receiving alerts

Check Dashboard β†’ Settings β†’ Notification channels. Use "Send Test" to verify. For Telegram, make sure you've started a conversation with your bot.

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. Heartbeats and cost data are buffered and sent automatically when the connection is restored.

Questions? Email [email protected]