# Zypher Agent

**Production-ready AI agents that live in your applications**

[![Build](https://github.com/corespeed-io/zypher-agent/actions/workflows/build.yml/badge.svg)](https://github.com/corespeed-io/zypher-agent/actions/workflows/build.yml)
[![JSR](https://jsr.io/badges/@zypher/agent)](https://jsr.io/badges/@zypher/agent)

## 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

```bash
deno add jsr:@zypher/agent
```

### SDK Usage

```typescript
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](https://zypher.corespeed.io/docs) for full usage
examples and API reference.

## License

Licensed under the Apache License, Version 2.0. See [LICENSE.md](LICENSE.md) for
details.

## Resources

- [Documentation](https://zypher.corespeed.io/docs) and
  [API Reference](https://jsr.io/@zypher/agent/doc)
- [Issue Tracker](https://github.com/corespeed-io/zypher-agent/issues)
- [Model Context Protocol](https://modelcontextprotocol.io/)

---

Built with ♥️ by [CoreSpeed](https://corespeed.io)