Skip to content

selfagency/agentsy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

400 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Tests codecov License: GPL-3.0-or-later

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

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