mux

module

v0.6.2 Latest Latest Go to latest Published: Feb 20, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/2389-research/mux

Links

Open Source Insights

README ¶

mux

Agentic infrastructure for Go. Tool execution, MCP integration, permission-gated approval flows, and orchestration.

Installation

go get github.com/2389-research/mux

Features

Tool Execution: Define and execute tools with structured input/output handling
MCP Integration: Full Model Context Protocol server and client implementations
Permission-Gated Approvals: Built-in approval flows for sensitive operations
Orchestration: Coordinate multi-step agentic workflows
Type Safety: Leverages Go's type system for reliable tool definitions
Extensible: Plugin architecture for custom tool implementations

Status

🚧 Under active development. API subject to change.

License

MIT

Directories ¶

Path	Synopsis
agent ABOUTME: Implements the Agent type - the top-level abstraction that wraps ABOUTME: orchestrator with per-agent tool filtering and hierarchy support.	ABOUTME: Implements the Agent type - the top-level abstraction that wraps ABOUTME: orchestrator with per-agent tool filtering and hierarchy support.
coordinator ABOUTME: Thread-safe cache with TTL expiration.	ABOUTME: Thread-safe cache with TTL expiration.
examples
full command ABOUTME: Full-featured mux example showing tools, child agents, coordinator.	ABOUTME: Full-featured mux example showing tools, child agents, coordinator.
minimal command ABOUTME: Minimal mux example - a simple agent with one tool.	ABOUTME: Minimal mux example - a simple agent with one tool.
simple command ABOUTME: Demonstrates basic mux usage - creating a simple agent with ABOUTME: built-in tools and running a conversation.	ABOUTME: Demonstrates basic mux usage - creating a simple agent with ABOUTME: built-in tools and running a conversation.
hooks ABOUTME: Defines the hook system for lifecycle events in mux.	ABOUTME: Defines the hook system for lifecycle events in mux.
llm ABOUTME: Anthropic API client implementing the llm.Client interface.	ABOUTME: Anthropic API client implementing the llm.Client interface.
mcp ABOUTME: Implements the Tool adapter - wraps MCP tools to implement ABOUTME: the mux Tool interface for seamless integration.	ABOUTME: Implements the Tool adapter - wraps MCP tools to implement ABOUTME: the mux Tool interface for seamless integration.
orchestrator ABOUTME: Core compaction logic for conversation context management.	ABOUTME: Core compaction logic for conversation context management.
permission ABOUTME: Implements the permission checker - evaluates rules and modes ABOUTME: to determine if tool execution should be allowed.	ABOUTME: Implements the permission checker - evaluates rules and modes ABOUTME: to determine if tool execution should be allowed.
tool ABOUTME: Implements the Executor - the permission-gated execution engine ABOUTME: that orchestrates tool calls with approval flows and hooks.	ABOUTME: Implements the Executor - the permission-gated execution engine ABOUTME: that orchestrates tool calls with approval flows and hooks.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL