The-Vibe-Company/companion

What it solves

Companion provides a centralized system for managing "Skills" (defined in SKILL.md libraries) and coordinating AI teammates known as Companions. It solves the problem of organizing, versioning, and deploying specific capabilities or instructions to AI agents across both personal and organizational contexts.

How it works

At its core, the project is a multi-tenant Skills Hub. It manages libraries of skills with features like labels, validation, immutable versioning, and dependency tracking. When the optional Companions control plane is enabled, the system creates named AI teammates, each associated with a persistent Box (via box.ascii.dev), a Pi daemon, and a durable chat thread.

The architecture is split into several specialized components:

• Web: A Next.js workspace for managing skills and chat threads.
• API: Handles authorization and control-plane intent.
• Worker: Manages background routines, GitHub synchronization, and notifications.
• Runtime: The sole process responsible for the Box/Pi lifecycle and executing turns.

Who it’s for

It is designed for individuals and organizations that want to self-host a structured environment for managing AI agent skills and deploying persistent AI teammates.

Highlights

• Multi-tenant Skill Management: Supports a hierarchy of Organization and User roles with private and shared skill libraries.
• Self-Hostable: Designed for deployment on infrastructure like Railway or local environments.
• Secure Architecture: Uses distinct least-privilege PostgreSQL roles for the API, worker, and runtime to ensure security.
• Integrated Runtime: Manages the lifecycle of AI agents through a dedicated runtime that interfaces with Box and Pi daemons.