Agentic Auxiliary Tools

Development tools and libraries for agentic workflows (MCP, CLIs, and Rust SDKs).

OpenCode is supported as a first-class workflow in this repo. The codebase uses just for task automation and xtask for repository maintenance. AI-assisted development is facilitated through per-crate CLAUDE.md files containing context and commands.

Why this is different

This repo treats MCP as the transport layer, not the product: it ships an opinionated harness for agentic workflows with orchestrated sessions, constrained agent roles, scoped tool access, and supporting CLIs like thoughts.

For the short version, see docs/why_this_stack.md. For the full architecture map, see workflow.md.

Docs / Setup

• Start here: docs/index.md
• Setup paths: docs/setup/README.md
• Troubleshooting: docs/troubleshooting.md

Primary Tools

agentic-mcp

Unified MCP server for all agentic-tools. Provides a single entry point for accessing the entire agentic-tools toolkit via the Model Context Protocol, enabling seamless integration with AI assistants and coding tools.

thoughts

CLI for flexible thought management using filesystem mounts. Unifies documentation across git repositories using mergerfs/FUSE, enabling automatic git synchronization and cross-platform support (Linux/macOS).

Note: Published on crates.io as thoughts-bin (it installs the thoughts binary).

claudecode

A Rust SDK for programmatically interacting with Claude Code. Provides type-safe event streaming, async-first API design, MCP support, and builder pattern configuration for launching and managing Claude sessions.

anthropic-async

Production-ready asynchronous client for Anthropic's API with prompt caching support. Includes Messages API (create, count tokens) and Models API with retry logic, exponential backoff, and strong typing.

gpt5_reasoner

GPT-5 prompt optimization and execution tool with MCP and CLI interfaces. Implements a two-phase approach: optimize prompts with Claude, then execute with GPT-5.2 xhigh reasoning. Supports directory-based file discovery with smart filtering.

Quick Start

# Clone repository
git clone https://github.com/allisoneer/agentic_auxilary
cd agentic_auxilary

# Build entire workspace
just build

# Build a specific crate
just crate-build agentic-mcp
just crate-build thoughts-bin
just crate-build claudecode

# Run tests
just test

# Check formatting and lints
just check

Installation

Install binaries from source

cargo install --path apps/agentic-mcp
cargo install --path apps/thoughts

Use claudecode in your project

[dependencies]
claudecode = "0.1.20"

Use anthropic-async in your project

[dependencies]
anthropic-async = "0.5.2"

Use opencode_rs in your project

[dependencies]
opencode_rs = "0.12.0"

Additional Tools

linear

• linear-tools - Linear issue tools via CLI + MCP

tools

• coding_agent_tools - Coding agent tools (CLI + MCP). First tool: ls.
• message_optimizer - Standalone GPT-5.4 message optimizer library
• pr_comments - Fetch GitHub PR comments via CLI and MCP
• review_tools - Review tools for agentic-mcp: diff snapshots, lens-based review, pagination
• thoughts-mcp-tools - MCP tool wrappers for thoughts-tool using agentic-tools framework
• web-retrieval - Web fetch and web search MCP tools
• workspace_tools - Workspace-scoped read/todowrite/edit/apply_patch tools

Supporting Libraries

agentic-tools

• agentic-tools-core - Core traits and types for agentic-tools library family
• agentic-tools-macros - Proc macros for agentic-tools library family
• agentic-tools-mcp - MCP server integration for agentic-tools library family
• agentic-tools-napi - N-API bindings for agentic-tools, enabling TypeScript/JavaScript integration
• agentic-tools-registry - Unified tool registry aggregating all agentic-tools domain registries
• agentic-tools-utils - Shared utilities for agentic-tools ecosystem: pagination, http, secrets, cli

infra

• agentic-config - Unified configuration system for agentic tools ecosystem
• agentic_logging - Centralized JSONL logging infrastructure for agentic tools
• gwt-worktree - Programmatic gwt-compatible git worktree management library
• thoughts-tool - Flexible thought management using filesystem mounts for git repositories

linear

• linear-queries - Cynic queries and input types for Linear
• linear-schema - Cached Linear GraphQL schema for cynic

services

• exa-async - Exa API client for Rust (async)
• opencode_rs - Rust SDK for OpenCode (HTTP-first hybrid with SSE streaming)

Development

Task Automation

This repository uses just for task automation. Common commands:

just check          # Check entire workspace (fmt + clippy)
just test           # Test entire workspace
just build          # Build entire workspace
just fmt            # Format entire workspace

# Per-crate commands
just crate-check <crate>    # Run formatting and clippy checks for a crate
just crate-test <crate>     # Run tests for a crate
just crate-build <crate>    # Build a crate

Repository Maintenance (xtask)

The xtask crate provides repository maintenance tooling:

just xtask-sync         # Sync autogen content (CLAUDE.md, release-plz.toml, README.md)
just xtask-verify       # Verify metadata, policy, and file freshness
just xtask-sync-check   # Check if sync is needed (for CI)
just xtask-verify-check # Full verification including generated files

AI-Assisted Development

Each crate has a CLAUDE.md file with crate-specific context and commands. The root CLAUDE.md provides repository-wide guidance.

Legacy

legacy

• universal-tool-core - DEPRECATED: Use agentic-tools-* crates and agentic-mcp instead. Core runtime library for Universal Tool Framework.
• universal-tool-integration-tests - universal-tool-integration-tests
• universal-tool-macros - DEPRECATED: Use agentic-tools-* crates and agentic-mcp instead. Procedural macros for Universal Tool Framework.

License

MIT - See LICENSE