aida-core

AIDA Core Plugin

The foundation for building your custom Claude Code experience.

Requires: Claude Code (latest) and Python 3.8+ (on Debian/Ubuntu, also python3-venv)

Why AIDA?

Claude Code is extensible — but there's no scaffolding. Building agents and skills from scratch means reinventing structure, conventions, and patterns every time. AIDA gives you the foundation to build on.

A bootstrap, not a box. AIDA provides the base layer — configuration management, extension scaffolding, session persistence — so you can focus on building the tools that matter to your workflow.

Standardized extension creation. Create agents, skills, and plugins with guided templates that follow consistent conventions. Run /aida agent create and get properly structured extensions without guessing at the format.

Configuration at every level. User-level defaults, project-level overrides, auto-detected environment settings. Your setup stays consistent across projects and portable across machines.

Structured session context. Mementos capture rich project state — not just facts, but the full context of what you're working on. Save mid-task, restore tomorrow, scoped to the project or your user profile.

Features

• Session Memory - Save and restore context across sessions with mementos
• Smart Configuration - Auto-detects your environment, tools, and project setup
• Extension Creation - Build agents and skills with guided templates
• Project Context - Claude understands your codebase patterns and conventions
• Health Diagnostics - Built-in troubleshooting with /aida doctor
• Expert Registry - Manage expert agents and panel compositions
• GitHub Integration - Easy bug reports and feature requests

Quick Start

Step 1: Add Marketplace

/plugin marketplace add oakensoul/aida-marketplace

Step 2: Install

/plugin install core@aida

Step 3: Configure

/aida config

Step 4: Verify

/aida status

For detailed walkthrough, see the Getting Started Guide.

Commands

Command	Description
/aida config	Configure AIDA (global or project)
/aida status	Check installation and configuration
/aida doctor	Run health diagnostics
/aida memento	Save/restore session context
/aida agent create	Create a custom agent
/aida skill create	Create a custom skill
/aida expert list	List available experts and status
/aida expert list configure	Select active experts for a project
/aida expert panel list	Show named panel compositions
/aida feedback	Submit feedback via GitHub
/aida bug	Report a bug
/aida feature-request	Request a feature

Documentation

Getting Started

• Getting Started - Quick onboarding guide
• Installation Guide - Detailed setup walkthrough
• Configuration Guide - Project configuration

How-To Guides

• Using Mementos - Save and restore session context
• Creating Agents - Build custom expert personas
• Creating Skills - Add execution capabilities
• Using Hooks - Automate with lifecycle events

Reference

• Examples - Real-world usage scenarios
• Extension Framework - Architecture and design

Requirements

• Claude Code - Latest version
• Python 3.8+ - For script execution (on Debian/Ubuntu, also python3-venv)
• gh CLI (optional) - For feedback features

Python dependencies are managed automatically. AIDA creates a virtual environment at ~/.aida/venv/ on first use -- no manual pip install required.

Architecture

AIDA extends Claude Code with a layered extension system:

agents/          # WHO - Expert personas
skills/          # HOW - Process definitions + execution capabilities

See ARCHITECTURE.md for detailed design.

Roadmap

Current: v1.3.x

• Expert registry for panel activation and composition
• Session persistence (mementos)
• Smart configuration with auto-detection
• Agent-based orchestration
• Extension creation (/aida agent|skill|plugin create)
• Hook management (/aida hook)
• Marketplace integration
• Security hardening and test coverage

Next: Sharing & Collaboration