Aegra Skill

Product summary

Aegra is an open-source, self-hosted Agent Protocol server for running LangGraph agents on your own infrastructure. It's a drop-in replacement for LangSmith Deployments with the same SDK, full persistence via PostgreSQL, streaming via Server-Sent Events, configurable authentication (JWT/OAuth/Firebase), and observability via OpenTelemetry. Key files: aegra.json (configuration), .env (environment variables), Dockerfile and docker-compose.yml (deployment). CLI commands: aegra init (create project), aegra dev (local development), aegra serve (production), aegra up (Docker stack). Primary docs: https://docs.aegra.dev

When to use

Reach for this skill when:

• Deploying agents — Setting up a self-hosted Aegra server for production or staging
• Configuring graphs — Defining LangGraph agents in aegra.json with authentication, custom routes, or semantic store
• Managing authentication — Implementing JWT, OAuth, Firebase, or custom auth handlers
• Building threads and state — Creating conversations, managing checkpoints, querying thread history
• Streaming responses — Implementing real-time agent output with SSE, handling reconnection
• Human-in-the-loop — Adding approval gates, interrupts, and user intervention points
• Observability — Configuring tracing to Langfuse, Phoenix, or generic OTLP backends
• Deployment — Running on Docker, PaaS (Railway, Render, Fly.io), or Kubernetes
• Troubleshooting — Debugging database connections, migrations, health checks, or worker issues