Agno v3.1.3 adds background runs to Claude and Codex agents

The agno-agi organization published release v3.1.3 of agno-agi/agno on GitHub on October 12, 2026. According to the release notes, nearly every change targets Agno's external agents, the ClaudeAgent and CodexAgent classes. They gain durable sessions, background runs, retries, metrics and structured output, and the release also adds a new AnakinTools toolkit.

Release facts

What changed

• Durable Claude sessions. The release notes say ClaudeAgent sessions now resume on any replica. The Claude SDK session id is stored on the Agno session. With a database that supports transcript storage, every transcript line is copied into a new agno_transcripts table, so a later turn on another machine resumes from the database instead of a local file.
• Background runs and cancellation. ClaudeAgent and CodexAgent accept background=True. They get durable-queue run ids, resumable indexed SSE and cancellation through /agents/{id}/runs/{run_id}/cancel, and they share the background task, slot and event-stream infrastructure that native agents use.
• Retries. Both classes take retries, delay_between_retries and exponential_backoff. A failed attempt is retried under the same run id and resumes the SDK session or Codex thread it started.
• Step replay for ClaudeAgent. continue_run takes continue_from, fork and input. Each tool result is a checkpoint listed by GET /agents/{id}/runs/{run_id}/checkpoints. Continuing a finished run creates a new sibling run instead of rewriting the original.
• Metrics. Runs report tokens, cache usage and cost (cost for Claude only) on RunOutput.metrics, along with duration and time_to_first_token. Completed runs add up into session metrics that AgentOS displays.
• Also listed: structured output through output_schema (a Pydantic model or a JSON Schema dict), image and file attachments, compaction, replay of stored events, SDK labels on the session APIs, and AnakinTools for Anakin.io's scrape, crawl, map and search APIs.

Questions

Which databases support resuming Claude sessions across replicas? The release notes name PostgresDb, AsyncPostgresDb, SqliteDb and AsyncSqliteDb as databases that support transcript storage. If a stored session cannot be resumed, Agno starts a fresh SDK session seeded with the Agno history.

Which failures are not retried? According to the release notes, limits are not retried: max_turns, max_budget_usd, and Codex budget and usage limits. Permanent errors are not retried either: authentication, billing, bad requests, context window and policy errors. Streaming consumers receive a type: "retry" warning event between attempts.

Can external agents take audio or video? No. The release notes say images and files can be attached to ClaudeAgent and CodexAgent runs, but audio and video are rejected with a 400 error instead of a server error.

Alternatives and other sourced Agno launches are listed on the Agno tool hub, and comparable tools in this directory include Mastra, OpenHands and OpenAI Agents.