perpetual-agents

Develop, debug, and test perpetual agents in the Agent Operating System.

2|1|Updated Mar 19, 2025
One-click install
npx skills add https://github.com/ASISaga/AgentOperatingSystem --skill perpetual-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perpetual-agents
Source: https://github.com/ASISaga/AgentOperatingSystem/tree/main/.github/skills/perpetual-agents
Command: npx skills add https://github.com/ASISaga/AgentOperatingSystem --skill perpetual-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides the foundational knowledge and patterns for developing, debugging, and testing perpetual AI agents within the Agent Operating System (AOS), enabling long-term autonomous operation.

Core Features & Use Cases

  • Perpetual Agent Development: Learn to create agents that run continuously, unlike traditional task-based agents.
  • State Persistence: Understand how agents maintain their state across operations using ContextMCPServer.
  • Purpose-Driven Design: Implement agents that operate towards a defined purpose and success criteria.
  • Use Case: Develop a customer support agent that remains active, learns from interactions, and persists its knowledge base indefinitely to provide consistent, evolving support.

Quick Start

Use the perpetual-agents skill to create a new leadership agent with a defined purpose and start its perpetual operation.

Frequently Asked Questions about perpetual-agents

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

FAQPage Schema
How do I build autonomous AI agents that run continuously instead of executing single tasks?

Build perpetual agents by applying purpose-driven design patterns and event handling logic within the Agent Operating System (AOS). Define a purpose with success criteria and manage the agent lifecycle to ensure continuous autonomous operation.

How does state persistence work for long-term autonomous agents?

State persistence for autonomous agents is managed via ContextMCPServer, which maintains and retrieves the agent's operational state across cycles. This ensures long-term memory and consistent behavior without losing context between events.

What is a perpetual agent and when do I need one for my application?

A perpetual agent is an autonomous AI entity designed for continuous, long-term operation towards a defined purpose rather than isolated task execution. You need one for use cases like customer support agents that must learn and persist knowledge indefinitely.

How do I test and debug purpose-driven agents in AOS?

Test and debug purpose-driven agents by following specific testing patterns for long-term operational AI within AOS. Validate event handling, state persistence via ContextMCPServer, and lifecycle management to ensure reliable continuous execution.

Can I use ContextMCPServer to maintain an evolving knowledge base for autonomous agents?

Yes, ContextMCPServer enables state persistence for autonomous agents, allowing them to maintain an evolving knowledge base across operations. This supports continuous learning and consistent application of persistent state over the agent's lifecycle.

What are the limitations of perpetual agents compared to traditional task-based agents?

Perpetual agents require robust state persistence and lifecycle management to handle continuous operation, unlike traditional task-based agents. They must be designed with explicit purpose and success criteria to prevent unbounded or unintended long-term autonomous behavior.