openagent

The open source AgentOS client.

Get Started →

---

Mission

Connect to AgentOS agents from the terminal.

Openagent is a terminal-first client for AgentOS. Whether you're developing and testing agents locally or connecting to production AgentOS deployments, openagent provides a polished TUI for discovering, chatting with, and managing your AI agents.

What is AgentOS?

AgentOS is the runtime and control plane for multi-agent systems. It transforms your agents into production-ready APIs with:

• 50+ API endpoints with SSE streaming out of the box
• Data sovereignty — sessions, memory, and traces stored in your database
• Enterprise security — JWT-based RBAC with hierarchical scopes
• Built-in observability — integrated tracing with no vendor lock-in
• Human-in-the-loop — guardrails and confirmation workflows

from agno.os import AgentOS
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.anthropic import Claude

agent = Agent(
    name="Agno Agent",
    model=Claude(id="claude-sonnet-4-5"),
    db=SqliteDb(db_file="agno.db"),
    add_history_to_context=True,
    markdown=True,
)

agent_os = AgentOS(agents=[agent])
app = agent_os.get_app()

if __name__ == "__main__":
    agent_os.serve(app="agno_agent:app", reload=True)

AgentOS handles the infrastructure so you can focus on building agents. Learn more at docs.agno.com.

Features

Openagent connects you to the AgentOS ecosystem:

• Agents & Teams — Connect to individual agents or multi-agent teams (Workflows coming soon)
• AgentOS Hub — Browse and connect to available agents via /agno command
• Agent Chat — Interact with agents using a polished terminal interface
• Tool Confirmation — Review and approve agent tool calls before execution
• Hot Reload — Press Ctrl+R to refresh agents after code changes
• Session Persistence — Continue conversations across sessions

AgentOS Hub — Browse and connect to available agents

Agent Details — View model and tool configuration

Teams — Connect to multi-agent teams

Quick Start

Prerequisites

• Bun and Git
• An AgentOS server running (see OPENAGENT.md for setup)

Install

git clone https://github.com/ajshedivy/openagent.git
cd openagent
./install.sh

This builds from source and installs the openagent binary to ~/.openagent/bin/. The script automatically adds it to your PATH.

Configure

Create openagent.json in your project directory:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "agentos": {
      "name": "AgentOS",
      "options": {
        "baseURL": "http://localhost:7777"
      }
    }
  }
}

Run

cd <your-project>
openagent

Use /agno to open the AgentOS Hub and connect to your agents.

Dev setup: If you're contributing, use bun install && bun dev instead. See CONTRIBUTING.md.

Documentation

• Get Started with OpenAgent — Full setup guide with example agent
• AgentOS Documentation — Build agents with Agno
• AgentOS Introduction — What is AgentOS?

Contributing

Interested in contributing? See our contributing guide.

---

Attribution

Openagent is built on opencode, an open source AI-powered terminal tool. We forked opencode to create a focused client for the AgentOS ecosystem while preserving all the great TUI infrastructure the opencode team built.

Thank you to the opencode team for making this possible.

• opencode repository
• opencode documentation
• opencode Discord