Documentation

Agent Programming Language

Define intelligent agents in a clean, declarative syntax. Compile to TypeScript, Python, or Go. Edit with full LSP support in your favorite editor.

Quick Start

1. Install the CLI

# npm
npm install -g @sagesyn/cli

# bun
bun add -g @sagesyn/cli

2. Create your first agent

sagesyn init hello.sag

This creates a new .sag file with a basic template:

agent: hello_world
version: 1.0

model:
  provider: anthropic
  name: claude-sonnet-4

workflow:
  - perceive: { from: trigger.user_input }
  - respond: { format: text, stream: true }

3. Compile to your target language

# Compile to TypeScript
sag compile hello.sag --target typescript

# Compile to Python
sag compile hello.sag --target python

# Compile to Go
sag compile hello.sag --target go

4. Run your agent

sag run hello.sag --input "Hello, world!"

Why a Dedicated Language?

Existing agent frameworks require you to write boilerplate code in Python, TypeScript, or other languages. You spend more time wiring things together than defining agent behavior.

The Agent Programming Language changes this. It provides a declarative syntax purpose-built for defining agents. MCP servers, A2A discovery, and AG-UI streaming are language primitives, not afterthoughts.

Write once, compile to TypeScript, Python, or Go. Your team uses whatever runtime they prefer. The language handles the translation.

Learn More

Language Reference

Complete syntax reference for .sag files

Compiler Targets

TypeScript, Python, and Go compilation

LSP & Editor Setup

VSCode, Vim, and Neovim extensions

Protocol Primitives

MCP, A2A, and AG-UI constructs

Full Documentation Coming Soon

We're actively building out the complete documentation. Join the GitHub community to get updates and early access.