For Platform Teams

Runbooks that
actually run.

Your wiki says “run this query” but doesn't actually run it. Caret creates living runbooks — executable docs where code runs inline and procedures stay current.

Works offline · Version history · Access control

Caret - AI-powered runbooks for platform teams

Sound familiar?

Documentation debt is real. Here's what you're dealing with.

📄

Runbooks that nobody trusts

The wiki says to run this command. But is it still valid? Last updated: 18 months ago. Good luck.

🧠

Knowledge trapped in senior engineers' heads

New team member asks how to debug X. Senior engineer shares screen, types magic commands. Nothing documented.

🌙

2am incidents with outdated docs

Pager goes off. You follow the runbook. Step 3 doesn't work anymore. Now you're debugging the runbook AND the incident.

🔄

Docs and code always out of sync

README says one thing, code does another. Someone updated the script but forgot the wiki.

Documentation that can't get stale

Because the code IS the documentation.

Before: Static Runbooks

Wiki page says:

“1. SSH into prod-db-01”

“2. Run: SELECT * FROM connections...”

“3. Kill connections with: SELECT pg_terminate...”

❓ Is this the right server name?

❓ Is this query syntax still valid?

❓ Did we change the threshold?

❓ Copy-paste errors in commands

After: Caret Runbooks
Live notebook:
1.“Connect to production”✓ Connected
2.“Show old connections”→ 3 results
3.“Terminate connections”→ Killed 3
4.“Verify count”→ 45/100 ✓
Every step executable. Every result verified.
db-connection-pool.caret
## 🚨 Database Connection Pool Exhaustion
Step 1: Check current connection count
Output
SELECT count(*) FROM pg_stat_activity;

Current connections: 95/100 ⚠️
Step 2: Find connections older than 5 minutes
Output
Found 3 idle connections:
┌──────┬────────────┬─────────┐
│ PID  │ Duration   │ State   │
├──────┼────────────┼─────────┤
│ 1234 │ 00:12:34   │ idle    │
│ 1235 │ 00:08:21   │ idle    │
│ 1236 │ 00:06:45   │ idle    │
└──────┴────────────┴─────────┘
Step 3: Terminate stale connections
Output
Terminated 3 connections.
Current connections: 92/100 ✓
How it works

Build runbooks engineers use

1

Document with code

Write context in markdown. Add executable code blocks. Readers understand the “why” and run the “how”.

2

Test by using

Every time someone uses the runbook, they're testing it. If something breaks, you know immediately.

3

Share & collaborate

Organize by service or incident type. Search across all procedures. Version history for accountability.

Templates

Start with proven procedures

Pre-built runbooks for common scenarios. Customize for your infrastructure.

Database Connection Pool Exhaustion
High Memory Usage Investigation
Disk Space Emergency Cleanup
Service Health Check
Deployment Rollback
Slow Query Investigation
Features

Built for infrastructure and reliability

Everything platform teams need for operational excellence.

Executable Documentation

Python, SQL, shell commands — all executable directly in the document. No copy-paste to terminal.

Database Connections

Connect to PostgreSQL, MySQL, MongoDB, Redis. Read-only mode for safety. Results as formatted tables.

Offline-First

Incident at 2am and VPN is flaky? Your runbooks are cached locally. Always accessible.

Version History

See who updated what and when. Roll back if changes break things. Compare versions side-by-side.

Variables & Parameters

Define variables at the top, reference throughout. Change one value, every command updates.

Access Control

Restrict dangerous runbooks to specific roles. Audit log shows who ran what and when.

Testimonials

Platform teams trust Caret

Our MTTR dropped 40% after moving runbooks to Caret. On-call engineers stopped wasting time on 'does this command still work?'
Sarah Kim
Staff SRE
Result
40% faster resolution
New engineers used to take 2 weeks to get comfortable with on-call. With executable runbooks, they're confident after day 3.
Marcus Johnson
Platform Lead
Result
4x faster onboarding
I used to dread writing docs because they'd be outdated in a month. Now our docs are always current because people run them.
Emily Chen
Senior Platform Engineer
Result
Zero stale runbooks

Build documentation your team will actually use.

Join platform teams shipping runbooks that work.

Free plan available · Upgrade anytime