convex-agents

Create persistent, stateful AI agents with thread management and streaming in Convex.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/Yahia89/ordering-food --skill convex-agents-yahia89
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-agents
Source: https://github.com/Yahia89/ordering-food/tree/main/.claude/skills/convex-agents
Command: npx skills add https://github.com/Yahia89/ordering-food --skill convex-agents-yahia89

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Builds and coordinates persistent, stateful AI agents that can manage long-running tasks, maintain conversation context, and orchestrate tools and services without losing progress across restarts.

Core Features & Use Cases

  • Persistent State: Agents retain conversation history and context across sessions.
  • Streaming Responses: Real-time token streaming to clients for responsive interactions.
  • Tool Integration & Orchestration: Run Convex functions as agent tools and compose multi-step workflows.
  • RAG & Knowledge Workflows: Integrate retrieval-augmented patterns for knowledge access and decision making.
  • Workflow Orchestration: Coordinate complex, durable processes that span multiple steps and services.
  • Use Cases: Personal assistants, customer support agents, and research assistants that need reliability and extensibility.

Quick Start

Set up a basic Convex Agent project and run a chat example to verify threading, streaming, and tool usage.

Frequently Asked Questions about convex-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I maintain conversation context for AI agents across server restarts?

Persistent state for AI agents is maintained by storing conversation history and context in a Convex environment. This allows agents to retain progress and resume long-running workflows seamlessly across sessions.

How do I stream AI agent responses in real-time to clients?

Real-time token streaming is enabled natively for AI agents within the Convex environment. This provides responsive client interactions by pushing tokens directly as they are generated during the workflow.

Can I use Convex functions as tools for RAG-enabled AI agents?

Yes, you can run Convex functions as agent tools. This enables tool integration and orchestration for retrieval-augmented generation (RAG) workflows, allowing agents to access knowledge and execute multi-step tasks.

What is the best way to orchestrate multi-step agent workflows without losing progress?

Orchestrating complex, durable processes that span multiple steps and services is best handled using persistent state with thread management. This ensures agents coordinate long-running tasks without losing progress.

Do I need a specific environment setup to manage long-running AI agent tasks?

Yes, you need a Convex environment and the Convex Agent component to wire up agents, threads, and tool integrations. This setup is required to manage long-running tasks and maintain conversation context.

Why does my stateful AI agent lose its conversation history between sessions?

Stateful AI agents lose conversation history without persistent state management. Implementing thread management within a Convex environment ensures conversation context is retained across sessions.