Skip to content

Docs: Replace "declarative TOML" with natural-language phrasing #484

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
FL4TLiN3 merged 2 commits into from
Feb 12, 2026
Merged

Docs: Replace "declarative TOML" with natural-language phrasing #484

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
aaf47fb
Docs: Replace "declarative TOML" with natural-language phrasing
FL4TLiN3 Feb 12, 2026
b8811c4
Update: Align tagline with GitHub description
FL4TLiN3 Feb 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Perstack: Agentic AI Runtime
# Perstack: The Declarative Runtime for Agentic AI

<p align="center">
<a href="https://www.npmjs.com/package/perstack"><img src="https://img.shields.io/npm/v/perstack" alt="npm version"></a>
Expand All @@ -16,7 +16,7 @@

- **`perstack` CLI**: Develop, test, and deploy Experts from the command line.
- **`create-expert` app**: Creates, tests, and refines new Experts in `perstack.toml` to your specification — powered by agentic AI.
- **`perstack.toml`**: Define and orchestrate reusable, domain-specialized agents as Experts in declarative TOML.
- **`perstack.toml`**: Define and orchestrate reusable, domain-specialized agents as Experts in natural language.
- **`@perstack/runtime`**: Execute Experts programmatically. Event-sourced state with step-level checkpoints — resume, replay, and audit any execution from any point.

## Quick Start
Expand Down
4 changes: 2 additions & 2 deletions docs/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: "Perstack: The Agent Runtime"
title: "Perstack: The Declarative Runtime for Agentic AI"
---

Define AI agents as declarative **Experts** in TOML. Execute them with deterministic, event-derived tracking. Each Expert runs in its own isolated context — no shared state, no prompt bloat, full execution history.
Define AI agents as **Experts** in natural language. Execute them with deterministic, event-derived tracking. Each Expert runs in its own isolated context — no shared state, no prompt bloat, full execution history.

- [Getting Started →](./getting-started/walkthrough.md)
- [Browse Registry →](https://platform.perstack.ai/)
Expand Down
2 changes: 1 addition & 1 deletion docs/contributing/roadmap.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ This roadmap outlines the direction of Perstack development. Priorities may shif

| Feature | Status | Version | Timeline | Description |
| ------------------------------ | :----: | ------- | --------- | ------------------------------------------------- |
| **Expert definitions** | ✅ | v0.0 | - | Declarative definitions in `perstack.toml` |
| **Expert definitions** | ✅ | v0.0 | - | Natural-language definitions in `perstack.toml` |
| **Runtime** | ✅ | v0.0 | - | Agent loop, checkpoint/restore, event sourcing |
| **Registry** | ✅ | v0.0 | - | Public registry with write-once versioning |
| **Skills (MCP)** | ✅ | v0.0 | - | MCP-based tool integration |
Expand Down
8 changes: 4 additions & 4 deletions docs/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
title: Perstack Documentation
description: Define AI agents as declarative Experts in TOML. Execute them with deterministic, event-derived tracking.
description: Define AI agents as Experts in natural language. Execute them with deterministic, event-derived tracking.
slug: docs
pagefind: true
---

Define AI agents as declarative **Experts** in TOML. Execute them with deterministic, event-derived tracking. Each Expert runs in its own isolated context — no shared state, no prompt bloat, full execution history.
Define AI agents as **Experts** in natural language. Execute them with deterministic, event-derived tracking. Each Expert runs in its own isolated context — no shared state, no prompt bloat, full execution history.

## Quick Start

Expand All @@ -21,11 +21,11 @@ npx perstack start code-reviewer "Review PR #42 for security issues"

## Why Perstack?

Agent frameworks help you **build** agents. Perstack is a **runtime** that **executes** them. You define Experts declaratively in TOML — Perstack handles execution, isolation, and state.
Agent frameworks help you **build** agents. Perstack is a **runtime** that **executes** them. You define Experts in natural language via TOML — Perstack handles execution, isolation, and state.

| | |
| :--- | :--- |
| **Declarative definitions** | Expert definitions in `perstack.toml` are plain text. Domain experts write the behavior; developers focus on integration. |
| **Natural-language definitions** | Expert definitions in `perstack.toml` are plain text. Domain experts write the behavior; developers focus on integration. |
| **Isolation by design** | Each Expert runs in its own context — workspace boundaries, environment sandboxing, and tool whitelisting. No shared state between runs. |
| **Event-derived execution** | Step-level checkpoints make runs reproducible. Resume from any step, debug, replay, and audit every decision. |
| **Multi-provider support** | Anthropic, OpenAI, Google, DeepSeek, Ollama, Azure, Bedrock, Vertex. Switch providers with one config change. |
Expand Down