Sandbox
@corespeed-io/zypher-agent

TypeScript framework for agent apps with tools and MCP

Zypher Agent is a framework for building production-ready agents in TypeScript. It provides a reactive agent loop, built-in file and terminal tools, MCP support, model provider support, and checkpoint handling.

330 stars23 forksTypeScriptUpdated 1mo ago
Who it's for

Builders who want to add agent behavior to their apps and keep control over tools, models, and execution flow.

What it delivers

You can ship agents that act on tools, use MCP servers, and keep checkpoints you can review or revert.

What it does

Reactive agent loop

The agent decides the next step from LLM output instead of following a fixed workflow.

Git-based checkpoints

You can track, review, and revert agent changes with built-in checkpoint management.

Extensible tool system

It includes file, search, and terminal tools, and lets you add custom tools.

MCP support

It can connect to MCP servers and supports OAuth authentication.

Multi-provider model support

It works with Anthropic Claude and OpenAI models through one interface.

Loop interceptors

You can customize behavior after inference with interceptor hooks.

Production controls

It includes timeouts, concurrency protection, and error handling for app use.

How to get it

  1. 1Run
    deno add jsr:@zypher/agent

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:@zypher/agent

SDK Usage

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

const agent = await createZypherAgent({
  model: "claude-sonnet-4-5-20250929", // Or use ModelProvider for advanced options
  tools: [...createFileSystemTools()],
  mcpServers: ["@modelcontextprotocol/sequentialthinking-server"],
});

// Run task with streaming
const taskEvents = agent.runTask("Implement authentication middleware");

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

Files in the repo

Repository payload10 top-level entries
  • .github
  • examples
  • packages
  • .env.example
  • .gitignore
  • CLAUDE.md
  • deno.json
  • deno.lock
  • LICENSE.md
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More frameworks & sdks

HKUDS/nanobotFrameworks & SDKs

Ultra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat apps

48k
microsoft/
SkillOpt
microsoft/SkillOptFrameworks & SDKs

SkillOpt is a text-space optimizer that trains reusable natural-language skills for frozen LLM agents through trajectory-driven edits, validation-gated updates, and deployable best_skill.md artifacts.

17k
omnigent-ai/omnigentFrameworks & SDKs

Omnigent is an open-source AI agent framework and meta-harness: orchestrate Claude Code, Codex, Cursor, Pi, and custom agents — swap harnesses without rewriting, enforce policies and sandboxing, and collaborate in real time from any device.

9.8k
kyegomez/
OpenMythos
kyegomez/OpenMythosFrameworks & SDKs

A theoretical reconstruction of the Claude Mythos architecture, built from first principles using the available research literature.

15k
D4Vinci/ScraplingFrameworks & SDKs

🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!

80k