Skip to content
Agent

Agents

by TinyAGI

AI Summary

TinyAGI supports running multiple AI agents simultaneously, each with its own isolated workspace, configuration, and conversation state. This allows you to have specialized agents for different tasks while maintaining complete isolation. The agent management feature enables you to: When a message ar

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to set up the "Agents" agent in my project.
Repository: https://github.com/TinyAGI/tinyagi

Please read the repo to find the agent definition file, then:
1. Download it to the correct location (.claude/agents/ or project root)
2. Include any companion files or templates it references
3. Explain what the agent does and how to invoke it

Description

TinyAGI is the agent teams orchestrator for One Person Company. (fka TinyClaw)

Overview

The agent management feature enables you to: • Run multiple agents with different models, providers, and configurations • Route messages to specific agents using @agent_id syntax • Isolate conversations - each agent has its own workspace directory and conversation history • Specialize agents - give each agent a custom system prompt and configuration • Switch providers - mix Anthropic (Claude) and OpenAI (Codex) agents • Customize workspaces - organize agents in your own workspace directory

Agents

TinyAGI supports running multiple AI agents simultaneously, each with its own isolated workspace, configuration, and conversation state. This allows you to have specialized agents for different tasks while maintaining complete isolation.

Architecture

`text ┌─────────────────────────────────────────────────────────────┐ │ Message Channels │ │ (Discord, Telegram, WhatsApp) │ └────────────────────┬────────────────────────────────────────┘ │ │ User sends: "@coder fix the bug" ↓ ┌─────────────────────────────────────────────────────────────┐ │ Queue Processor │ │ • Parses @agent_id routing prefix │ │ • Falls back to default agent if no prefix │ │ • Loads agent configuration from settings.json │ └────────────────────┬────────────────────────────────────────┘ │ ↓ ┌─────────────────────────────────────────────────────────────┐ │ Agent Router │ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ @coder │ │ @writer │ │ @assistant │ │ │ │ │ │ │ │ (default) │ │ │ │ Provider: │ │ Provider: │ │ Provider: │ │ │ │ anthropic │ │ openai │ │ anthropic │ │ │ │ Model: │ │ Model: │ │ Model: │ │ │ │ sonnet │ │ gpt-5.3-codex│ │ opus │ │ │ │ │ │ │ │ │ │ │ │ Workspace: │ │ Workspace: │ │ Workspace: │ │ │ │ ~/workspace/ │ │ ~/workspace/ │ │ ~/workspace/ │ │ │ │ coder/ │ │ writer/ │ │ assistant/ │ │ │ │ │ │ │ │ │ │ │ │ Config: │ │ Config: │ │ Config: │ │ │ │ .claude/ │ │ .claude/ │ │ .claude/ │ │ │ │ heartbeat.md │ │ heartbeat.md │ │ heartbeat.md │ │ │ │ AGENTS.md │ │ AGENTS.md │ │ AGENTS.md │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │ │ │ Shared: ~/.tinyagi/ (channels, files, logs, tinyagi.db) │ └─────────────────────────────────────────────────────────────┘ `

1. Message Routing

When a message arrives, the queue processor parses it for routing: `typescript // User sends: "@coder fix the authentication bug" const routing = parseAgentRouting(rawMessage, agents); // Result: { agentId: "coder", message: "fix the authentication bug" } ` Routing Rules: • Message starts with @agent_id → Routes to that agent • No prefix → Routes to default agent (user-named during setup) • Agent not found → Falls back to default agent • No agents configured → Uses legacy single-agent mode

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted Today
Active
Adoption1K+ stars on GitHub
3.2k ★ · Popular
DocsMissing or thin
Undocumented

GitHub Signals

Stars3.2k
Forks463
Issues67
UpdatedToday
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code
Claude.ai