Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -43,3 +43,6 @@ next-env.d.ts
# SDK output
ts-sdk/dist
ts-sdk/node_modules

# Sentry Config File
.env.sentry-build-plugin
30 changes: 22 additions & 8 deletions .source/index.ts
Original file line number Diff line number Diff line change
@@ -1,11 +1,25 @@
// @ts-nocheck -- skip type checking
import * as docs_6 from "../content/docs/self-hosting.mdx?collection=docs&hash=1751511820793"
import * as docs_5 from "../content/docs/sdk.mdx?collection=docs&hash=1751511820793"
import * as docs_4 from "../content/docs/prompt-authoring.mdx?collection=docs&hash=1751511820793"
import * as docs_3 from "../content/docs/index.mdx?collection=docs&hash=1751511820793"
import * as docs_2 from "../content/docs/git-sync.mdx?collection=docs&hash=1751511820793"
import * as docs_1 from "../content/docs/getting-started.mdx?collection=docs&hash=1751511820793"
import * as docs_0 from "../content/docs/core-concepts.mdx?collection=docs&hash=1751511820793"
import * as docs_20 from "../content/docs/studio/sync-events.mdx?collection=docs&hash=1753296249963"
import * as docs_19 from "../content/docs/studio/settings.mdx?collection=docs&hash=1753296249963"
import * as docs_18 from "../content/docs/studio/prompts.mdx?collection=docs&hash=1753296249963"
import * as docs_17 from "../content/docs/studio/project.mdx?collection=docs&hash=1753296249963"
import * as docs_16 from "../content/docs/studio/organization.mdx?collection=docs&hash=1753296249963"
import * as docs_15 from "../content/docs/studio/metrics.mdx?collection=docs&hash=1753296249963"
import * as docs_14 from "../content/docs/studio/logs.mdx?collection=docs&hash=1753296249963"
import * as docs_13 from "../content/docs/studio/globals.mdx?collection=docs&hash=1753296249963"
import * as docs_12 from "../content/docs/studio/alerts.mdx?collection=docs&hash=1753296249963"
import * as docs_11 from "../content/docs/studio/account.mdx?collection=docs&hash=1753296249963"
import * as docs_10 from "../content/docs/sdk/reference.mdx?collection=docs&hash=1753296249963"
import * as docs_9 from "../content/docs/sdk/index.mdx?collection=docs&hash=1753296249963"
import * as docs_8 from "../content/docs/sdk/basic-usage.mdx?collection=docs&hash=1753296249963"
import * as docs_7 from "../content/docs/sdk/agentsmith-folder.mdx?collection=docs&hash=1753296249963"
import * as docs_6 from "../content/docs/sdk/advanced-usage.mdx?collection=docs&hash=1753296249963"
import * as docs_5 from "../content/docs/core-concepts/self-hosting.mdx?collection=docs&hash=1753296249963"
import * as docs_4 from "../content/docs/core-concepts/architecture.mdx?collection=docs&hash=1753296249963"
import * as docs_3 from "../content/docs/syncing.mdx?collection=docs&hash=1753296249963"
import * as docs_2 from "../content/docs/quick-start.mdx?collection=docs&hash=1753296249963"
import * as docs_1 from "../content/docs/prompt-authoring.mdx?collection=docs&hash=1753296249963"
import * as docs_0 from "../content/docs/index.mdx?collection=docs&hash=1753296249963"
import { _runtime } from "fumadocs-mdx"
import * as _source from "../source.config"
export const docs = _runtime.docs<typeof _source.docs>([{ info: {"path":"core-concepts.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/core-concepts.mdx"}, data: docs_0 }, { info: {"path":"getting-started.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/getting-started.mdx"}, data: docs_1 }, { info: {"path":"git-sync.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/git-sync.mdx"}, data: docs_2 }, { info: {"path":"index.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/index.mdx"}, data: docs_3 }, { info: {"path":"prompt-authoring.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/prompt-authoring.mdx"}, data: docs_4 }, { info: {"path":"sdk.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/sdk.mdx"}, data: docs_5 }, { info: {"path":"self-hosting.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/self-hosting.mdx"}, data: docs_6 }], [])
export const docs = _runtime.docs<typeof _source.docs>([{ info: {"path":"index.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/index.mdx"}, data: docs_0 }, { info: {"path":"prompt-authoring.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/prompt-authoring.mdx"}, data: docs_1 }, { info: {"path":"quick-start.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/quick-start.mdx"}, data: docs_2 }, { info: {"path":"syncing.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/syncing.mdx"}, data: docs_3 }, { info: {"path":"core-concepts/architecture.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/core-concepts/architecture.mdx"}, data: docs_4 }, { info: {"path":"core-concepts/self-hosting.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/core-concepts/self-hosting.mdx"}, data: docs_5 }, { info: {"path":"sdk/advanced-usage.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/sdk/advanced-usage.mdx"}, data: docs_6 }, { info: {"path":"sdk/agentsmith-folder.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/sdk/agentsmith-folder.mdx"}, data: docs_7 }, { info: {"path":"sdk/basic-usage.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/sdk/basic-usage.mdx"}, data: docs_8 }, { info: {"path":"sdk/index.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/sdk/index.mdx"}, data: docs_9 }, { info: {"path":"sdk/reference.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/sdk/reference.mdx"}, data: docs_10 }, { info: {"path":"studio/account.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/studio/account.mdx"}, data: docs_11 }, { info: {"path":"studio/alerts.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/studio/alerts.mdx"}, data: docs_12 }, { info: {"path":"studio/globals.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/studio/globals.mdx"}, data: docs_13 }, { info: {"path":"studio/logs.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/studio/logs.mdx"}, data: docs_14 }, { info: {"path":"studio/metrics.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/studio/metrics.mdx"}, data: docs_15 }, { info: {"path":"studio/organization.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/studio/organization.mdx"}, data: docs_16 }, { info: {"path":"studio/project.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/studio/project.mdx"}, data: docs_17 }, { info: {"path":"studio/prompts.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/studio/prompts.mdx"}, data: docs_18 }, { info: {"path":"studio/settings.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/studio/settings.mdx"}, data: docs_19 }, { info: {"path":"studio/sync-events.mdx","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/studio/sync-events.mdx"}, data: docs_20 }], [{"info":{"path":"meta.json","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/meta.json"},"data":{"title":"Documentation","pages":["index","quick-start","---","prompt-authoring","syncing","core-concepts","studio","sdk"]}}, {"info":{"path":"core-concepts/meta.json","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/core-concepts/meta.json"},"data":{"title":"Core Concepts","pages":["architecture","self-hosting"]}}, {"info":{"path":"sdk/meta.json","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/sdk/meta.json"},"data":{"title":"SDK","pages":["index","basic-usage","advanced-usage","agentsmith-folder","---","reference"]}}, {"info":{"path":"studio/meta.json","absolutePath":"/Users/lanzo/projects/agentsmith/content/docs/studio/meta.json"},"data":{"title":"Studio","pages":["project","prompts","logs","metrics","sync-events","globals","account","organization","alerts","settings"]}}])
9 changes: 9 additions & 0 deletions .source/source.config.mjs
Original file line number Diff line number Diff line change
@@ -1,8 +1,17 @@
// source.config.ts
import { defineDocs } from "fumadocs-mdx/config";
import { remarkAutoTypeTable, createGenerator } from "fumadocs-typescript";
import { defineConfig } from "fumadocs-mdx/config";
var docs = defineDocs({
dir: "content/docs"
});
var generator = createGenerator();
var source_config_default = defineConfig({
mdxOptions: {
remarkPlugins: [[remarkAutoTypeTable, { generator }]]
}
});
export {
source_config_default as default,
docs
};
2 changes: 1 addition & 1 deletion .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"deno.enable": true,
"deno.enablePaths": ["./supabase/functions"],
"deno.importMap": "./supabase/functions/import_map.json"
"deno.importMap": "./supabase/functions/deno.json"
}
3 changes: 1 addition & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,8 @@

[![License](https://img.shields.io/badge/License-Apache_2.0-lightgrey.svg)](https://opensource.org/licenses/Apache-2.0)
[![Website](https://img.shields.io/badge/agentsmith.app-brightgreen)](https://agentsmith.app)
[![Alpha Club](https://img.shields.io/badge/Join%20Alpha%20Club-blueviolet)](https://agentsmith.app/#pricing)
[![Plans & Pricing](https://img.shields.io/badge/Join%20Alpha%20Club-blueviolet)](https://agentsmith.app/#pricing)
[![Roadmap](https://img.shields.io/badge/Roadmap-blue)](https://agentsmith.app/roadmap)
[![Join Waitlist](https://img.shields.io/badge/Join%20Waitlist-ff69b4)](https://agentsmith.app/#join-waitlist)

## Overview

Expand Down
39 changes: 0 additions & 39 deletions content/docs/core-concepts.mdx

This file was deleted.

69 changes: 69 additions & 0 deletions content/docs/core-concepts/architecture.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
---
title: Architecture
description: Learn how Agentsmith works
---

import { Alert, AlertTitle, AlertDescription } from '@/components/ui/alert';
import { Info } from 'lucide-react';
import { Mermaid } from '@/components/docs/mermaid';

At its core, Agentsmith is a platform designed to bridge the gap between prompt engineering and production-ready code. It provides a structured, version-controlled, and type-safe workflow for developing and deploying AI agents.

Agentsmith consists of several key components that work together to provide a seamless experience from authoring to execution.

<Mermaid
chart={`
graph TD
A["<div style='font-weight:bold'>Agentsmith Studio</div><div style='font-size: smaller'>Visual prompt authoring</div>"]
subgraph " "
direction LR
B["<div style='font-weight:bold'>Your Application</div><div style='font-size: smaller'>Code using the Agentsmith SDK</div>"]
E["LLM execution"]
D["<div style='font-weight:bold'>OpenRouter</div><div style='font-size: smaller'>LLM gateway</div>"]
end
C["<div style='font-weight:bold'>GitHub Repository</div>"]
A -- "Syncs Button" --> C
C -- "Git Webhooks" --> A
C -- "git pull" --> B
A -- "Studio Executions" --> E
B -- "SDK Executions" --> E
E --> D
E -- "LLM Response Logged to Agentsmith" --> A
style A fill:#E3E7F1,stroke:#4A5568
style B fill:#D4EDEA,stroke:#4A5568
style C fill:#f5f5f5,stroke:#4A5568
style D fill:#fff0e6,stroke:#4A5568
style E fill:#fff0e6,stroke:#4A5568
`}
/>

1. **Agentsmith Studio**: A web-based interface for authoring, testing, and managing your prompts. This is where non-technical team members can collaborate with developers.
2. **GitHub**: Your Git repository acts as the single source of truth for all versioned prompts.
3. **Your Application**: The codebase where you install the Agentsmith SDK to consume and execute prompts.
4. **OpenRouter**: The gateway we use for all LLM calls. This provides flexibility, allowing you to switch between models from different providers without changing your code.

<Alert variant="default">
<Info />
<AlertTitle>What is OpenRouter?</AlertTitle>
<AlertDescription>
We use [OpenRouter](https://openrouter.ai/) to provide a unified API for a vast range of LLMs.
This means you can experiment with different models, find the most cost-effective one for your
needs, and switch seamlessly, all without being locked into a single provider.
</AlertDescription>
</Alert>

## The Development Workflow

The core philosophy of Agentsmith revolves around a "Git-as-source-of-truth" workflow that combines the best of visual editing and code-based reliability.

- **Author & Test**: Prompts are created and tested in the visual Studio.
- **Sync & Version**: Prompts are synced to your Git repository as versioned files. This creates a durable, reviewable history of all changes.
- **Develop & Execute**: The type-safe SDK consumes these files in your application, ensuring that the prompts you execute match what's in your repository.

This workflow ensures that changes to prompts can be reviewed, tested, and deployed with the same rigor as any other code change in your project.

To learn more about the details, explore the following sections:

- **[Prompt Authoring](/docs/prompt-authoring)**
- **[Git Sync](/docs/git-sync)**
- **[Using the SDK](/docs/sdk)**
4 changes: 4 additions & 0 deletions content/docs/core-concepts/meta.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"title": "Core Concepts",
"pages": ["architecture", "self-hosting"]
}
Original file line number Diff line number Diff line change
Expand Up @@ -207,10 +207,7 @@ After deployment, verify that:
<Info />
<AlertTitle>Need Support?</AlertTitle>
<AlertDescription>
If you encounter issues with self-hosting, please reach out to our support team at{' '}
<a href="mailto:support@agentsmith.app" className="underline">
support@agentsmith.app
</a>
. We're here to help!
If you encounter issues with self-hosting, please reach out to our support team at
support@agentsmith.app. We're here to help!
</AlertDescription>
</Alert>
47 changes: 0 additions & 47 deletions content/docs/getting-started.mdx

This file was deleted.

35 changes: 0 additions & 35 deletions content/docs/git-sync.mdx

This file was deleted.

Loading