MCPcopy Index your code
hub / github.com/corespeed-io/zypher-agent

github.com/corespeed-io/zypher-agent @v0.6.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.6.1 ↗ · + Follow
328 symbols 617 edges 62 files 117 documented · 36% updated 4mo agoui/v0.3.3 · 2026-03-04★ 337
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Zypher Agent

Production-ready AI agents that live in your applications

Build JSR

Features

  • Agent, Not Workflow: Reactive loop where the agent dynamically decides next steps based on LLM reasoning.
  • Git-Based Checkpoints: Track, review, and revert agent changes with built-in checkpoint management
  • Extensible Tool System: Built-in tools for file operations, search, and terminal commands with support for custom tools
  • Model Context Protocol (MCP): Native support for MCP servers with OAuth authentication
  • Multi-Provider Support: Works with Anthropic Claude and OpenAI GPT models through a unified interface
  • Loop Interceptor System: Customize agent behavior with extensible post-inference interceptors
  • Production-Ready: Configurable timeouts, concurrency protection, and comprehensive error handling

Quick Start

Installation

[!NOTE] Support for npm coming soon.

Using JSR

deno add jsr:@corespeed/zypher

SDK Usage

import { AnthropicModelProvider, createZypherAgent } from "@corespeed/zypher";
import { createFileSystemTools } from "@corespeed/zypher/tools";
import { eachValueFrom } from "rxjs-for-await";

const agent = await createZypherAgent({
  modelProvider: new AnthropicModelProvider({
    apiKey: Deno.env.get("ANTHROPIC_API_KEY")!,
  }),
  tools: [...createFileSystemTools()],
  mcpServers: ["@modelcontextprotocol/sequentialthinking-server"],
});

// Run task with streaming
const taskEvents = agent.runTask(
  "Implement authentication middleware",
  "claude-sonnet-4-20250514",
);

for await (const event of eachValueFrom(taskEvents)) {
  console.log(event);
}

See our documentation for full usage examples and API reference.

License

Licensed under the Apache License, Version 2.0. See LICENSE.md for details.

Resources


Built with ♥️ by CoreSpeed

Extension points exported contracts — how you extend this code

LoopInterceptor (Interface)
(no doc) [6 implementers]
src/loopInterceptors/interface.ts
ModelProvider (Interface)
(no doc) [4 implementers]
src/llm/ModelProvider.ts
StorageService (Interface)
(no doc) [2 implementers]
src/storage/StorageService.ts
McpServerState (Interface)
* Represents the internal state of an MCP server including its configuration, * client connection, source information,
src/mcp/McpServerManager.ts
Tool (Interface)
(no doc) [1 implementers]
src/tools/mod.ts
ZypherContext (Interface)
(no doc)
src/ZypherAgent.ts
Checkpoint (Interface)
(no doc)
src/CheckpointManager.ts
TaskTextEvent (Interface)
(no doc)
src/TaskEvents.ts

Core symbols most depended-on inside this repo

resolve
called by 21
src/utils/completer.ts
registerServer
called by 20
src/mcp/McpServerManager.ts
runCommand
called by 15
src/utils/mod.ts
wait
called by 14
src/ZypherAgent.ts
fileExists
called by 13
src/utils/data.ts
convertServerDetailToEndpoint
called by 13
src/mcp/utils.ts
createTool
called by 12
src/tools/mod.ts
dispose
called by 12
src/mcp/McpClient.ts

Shape

Method 143
Function 80
Interface 60
Class 44
Enum 1

Languages

TypeScript100%

Modules by API surface

src/mcp/McpClient.ts27 symbols
src/loopInterceptors/errorDetection/TypeScriptErrorDetector.ts21 symbols
src/llm/Anthropic.ts18 symbols
src/mcp/McpServerManager.ts16 symbols
src/ZypherAgent.ts16 symbols
src/storage/S3StorageService.ts15 symbols
src/storage/StorageService.ts13 symbols
src/mcp/InMemoryOAuthProvider.ts13 symbols
src/message.ts12 symbols
src/llm/OpenAI.ts12 symbols
src/llm/ModelProvider.ts12 symbols
src/TaskEvents.ts11 symbols

For agents

$ claude mcp add zypher-agent \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page