Agentsy

Composable infrastructure for LLM and agentic systems.

Agentsy is a pnpm/turborepo monorepo of focused @agentsy/* packages for stream processing, provider integration, orchestration/runtime execution, state and memory systems, and integration surfaces.

Current repository state

This workspace currently contains 24 manifest-backed packages.

Canonical architecture boundaries

• Core stream/transformation primitives: @agentsy/core, @agentsy/types
• Provider adaptation + normalization boundary: @agentsy/providers, @agentsy/mcp
• Orchestration and execution: @agentsy/orchestrator, @agentsy/runtime, @agentsy/guardrails
• Durability and long-horizon state: @agentsy/session, @agentsy/memory, @agentsy/context, @agentsy/retrieval
• Surface and presentation: @agentsy/renderers, @agentsy/ui, @agentsy/vscode, @agentsy/cli, @agentsy/connectors
• Extensibility and harness contracts: @agentsy/plugins

Ownership highlights

• Framework-level setup and doctor UX belongs to @agentsy/cli.
• Helper or background agent roles belong to @agentsy/orchestrator and @agentsy/runtime.
• Host-specific integration complexity belongs to @agentsy/plugins, @agentsy/vscode, @agentsy/mcp, and @agentsy/connectors.
• @agentsy/context remains a library package for context shaping primitives rather than an operator-facing product shell.

Important: @agentsy/providers is currently active and not merged away into @agentsy/core.

Build and test

pnpm install
pnpm build
pnpm check-types
pnpm test

Optional:

pnpm test:coverage
pnpm lint
pnpm format

Project documentation

• Docs home
• Getting started
• Package catalog
• Architecture overview
• Roadmap
• Developer docs
• Dogfood implementation plan
• Master implementation plan

Dogfood implementation

The repository now follows plan/DOGFOOD-PLAN.md as the active production sequence for CLI-first delivery. Start there when implementing the next vertical slice.

Configuration

The @agentsy/cli package provides a full configuration system:

# Configuration management
agentsy config list                    # List all config values
agentsy config set <key> <value>       # Set a config value
agentsy doctor                         # Full system diagnostics

# MCP and connectors
agentsy mcp list                       # List registered MCP servers
agentsy connectors list                # List configured connectors

Configuration is stored in ~/.config/agentsy/config.json with support for profiles, environment overrides (AGENTSY_*), schema validation, and secrets integration.

Phase 10+11 capabilities

The following capabilities were completed in Phases 10 and 11:

• Configuration system: agentsy config, agentsy settings, agentsy doctor config
• MCP CLI: Register, list, and manage MCP servers from the CLI
• Connectors CLI: Add, remove, and manage platform connectors (Discord, Slack, Telegram)
• Guardrails CLI: Safety and validation boundary management
• All plan-only domains promoted: connectors, guardrails, mcp, retrieval are now manifest-backed packages
• Integration tests: All networked integration tests pass with MSW mocks

License

MIT