skrun
Deploy any Agent Skill as an API via POST /run. The open-source multi-model alternative to Claude Managed Agents, Microsoft Foundry & Mistral/Koyeb — works with any LLM.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/skrun-dev/skrun with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/skrun-dev/skrun'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/skrun-dev--skrun)HTML
<a href="/listings/skrun-dev--skrun"><img src="/api/listings/skrun-dev--skrun/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npm install -g @skrun-dev/cli
skrun init --from-skill ./my-skill # or: skrun init my-agent
skrun deploy -m "initial release" # build + push + get your API URL
skrun verify dev/my-skill@1.0.0 # admin step — auto-admin in local dev
skrun run dev/my-skill -i '{"query":"analyze this"}'That's it. Your agent is verified, callable via the CLI, and reachable as a `POST /run` HTTP endpoint:
curl -X POST http://localhost:4000/api/agents/dev/my-skill/run \
-H "Authorization: Bearer dev-token" \
-H "Content-Type: application/json" \
-d '{"input": {"query": "analyze this"}}'> `dev-token` is for local development. In production, authenticate via [GitHub OAuth or API keys](docs/api.md#authentication) — your GitHub username becomes your namespace, and `skrun verify` is governed by the operator [verification policy](docs/self-hosting.md#verification-policy) (admin-only by default; creators can self-attest under `owner`).
→ **[10-minute tutorial](docs/getting-started.md)** · **[Concepts](docs/concepts.md)** · **[API reference](docs/api.md)**
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 382 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <p align="center">
- <img src="assets/banner.svg" alt="Skrun — Deploy any Agent Skill as an API" width="600">
- </p>
- <h1 align="center">Skrun</h1>
- <p align="center">
- <b>Deploy any Agent as an API via <code>POST /run</code>.</b><br>
- The open, multi-model runtime for AI agents — works with any LLM, on any infrastructure.
- </p>
- <p align="center">
- <sub>The open-source alternative to Claude Managed Agents (CMA) and Google's
- Gemini Enterprise Agent Platform (GEAP) — multi-model, self-hostable, MIT.</sub>
- </p>
- <p align="center">
- <a href="https://github.com/skrun-dev/skrun/actions"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/skrun-dev/skrun/ci.yml?branch=main&style=for-the-badge&logo=github&label=CI"></a>
- <a href="https://www.npmjs.com/package/@skrun-dev/cli"><img alt="npm CLI" src="https://img.shields.io/npm/v/@skrun-dev/cli?style=for-the-badge&logo=npm&label=CLI&color=CB3837"></a>
- <a href="https://www.npmjs.com/package/@skrun-dev/sdk"><img alt="npm SDK" src="https://img.shields.io/npm/v/@skrun-dev/sdk?style=for-the-badge&logo=npm&label=SDK&color=CB3837"></a>
- <a href="https://github.com/skrun-dev/skrun/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/skrun-dev/skrun?style=for-the-badge&logo=github&color=FFD700"></a>
- <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge"></a>
- </p>
- <p align="center">
- <img alt="Node" src="https://img.shields.io/badge/Node-%E2%89%A520-339933?style=for-the-badge&logo=node.js&logoColor=white">
- <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-strict-3178C6?style=for-the-badge&logo=typescript&logoColor=white">
- <img alt="MCP" src="https://img.shields.io/badge/MCP-compatible-8B5CF6?style=for-the-badge">
- </p>
- <p align="center">
- <a href="#-why-skrun">Why</a> ·
- <a href="#️-use-cases">Use Cases</a> ·
- <a href="#-quick-start">Quick Start</a> ·
- <a href="#-dashboard">Dashboard</a> ·
- <a href="#-sdk">SDK</a> ·
- <a href="#-features">Features</a> ·
- <a href="#-documentation">Docs</a>
- </p>
- <p align="center">
- <img src="docs/assets/flow.gif" alt="Skrun demo: push an agent, explore the dashboard, run it in the playground" width="800">
- </p>
- <p align="center"><sub>
- <b>4 steps:</b> (1) <code>skrun deploy -m "initial release"</code> from your terminal →
- (2) the agent appears in the dashboard →
- (3) open the Playground, fill the input →
- (4) click Run, watch SSE events stream in real time, see the result.
- </sub></p>
- ---
- ## 🎯 Why Skrun?
- You shipped an AI capability. It works on your machine. But every user, every customer, every new model brings new plumbing.
- **Skrun is the open agent runtime.** Turn your skill — declared as `SKILL.md`, `AGENTS.md`, or your own format — into a `POST /run` endpoint. Without building your own agent loop. Without picking a vendor. Without locking your users behind a wall.
- **Any model. Any cloud. BYOK. MIT.** Your skill stays portable.
- ### What you get
- - ✅ Your skill stays in your repo, in the format you choose. Skrun is a deployment target — your repo stays the source of truth.
- - ✅ Compatible with the [Agent Skills open standard](https://agentskills.io) (`SKILL.md`) and [AGENTS.md](https://agents.md) (Linux Foundation). Your existing skill works.
- - ✅ Users bring their own LLM keys. You're never on the hook for their costs.
- - ✅ Self-host on your infrastructure (Node 22.19+, SQLite or Postgres). [Self-hosting guide](docs/self-hosting.md). Or the managed cloud: [quick start](https://skrun.sh/docs/quickstart).
- - ✅ MIT. Multi-model: Claude, GPT, Gemini, Mistral, Groq, Grok, Ollama.
- - ✅ Wrap existing scripts gradually. No big-bang rewrite required.
- ### Skrun vs vendor runtimes
- | | Skrun | CMA / GEAP / Vendor runtimes |
- |--|-------|-----------------|
- | **Models** | Claude, GPT, Gemini, Mistral, Groq, Grok + any OpenAI-compatible endpoint (DeepSeek, Kimi, Qwen, Ollama, vLLM…) | One provider only |
- | **Deployment** | Self-hosted (Node + SQLite/Postgres) or our cloud ([quick start](https://skrun.sh/docs/quickstart)) | Vendor cloud only |
- | **Format** | `SKILL.md` ([agentskills.io](https://agentskills.io), 40+ platforms), `AGENTS.md` ([Linux Foundation](https://agents.md)), or your own | Proprietary |
- | **Streaming** | SSE + async webhooks | Varies |
- | **License** | MIT | Closed |
- | **Auth** | GitHub OAuth + API keys — multi-tenant namespaces | Vendor console only |
- | **LLM keys** | Bring your own keys | Vendor billing only |
- ---
- ## 🏗️ Use Cases
- ### 🚀 For OSS skill maintainers — close the issues you can't answer today
- You wrote `changelog-generator` (or `research-to-brief`, or `incident-postmortem`). It works in Claude Code. Stars are climbing. Then someone opens issue #34: *"How do I run this from a CI pipeline?"* Issue #41: *"Can I integrate this with Linear?"* Issue #58: *"My status-page automation needs this."*
- Today you respond: *"Sorry, this is a SKILL.md — you need Claude Code installed."* Half abandon.
- **With Skrun:** `skrun deploy`, you reply with a curl command. Issue closed in 5 minutes instead of 3 hours of setup. The drop-off between "starred it" and "actually running it" disappears.
- ### 🛠️ For internal AI platforms — visibility and standardization without rewriting
- Your team has accumulated 12 LLM-powered scripts in 2 years. Each engineer rolled their own. One left last week — three of his scripts are crashing silently. Your LLM bill went 5x without explanation. The board asked twice "what's our AI strategy?" — you don't have one.
- **With Skrun:** wrap existing scripts gradually as skills (or `AGENTS.md`, or your own format). No big-bang rewrite. One dashboard for all AI calls — cost per feature, failure modes, ownership. Your team standardizes on one declarative format. New engineers read a manifest in 30 seconds instead of reverse-engineering 800 lines.
- ### 🎯 For freelance & agencies — stop bricolating per-client AI deliveries
- Each new client means 2-3 weeks of build. You glue Express + Anthropic SDK + Vercel for each delivery. The plumbing is identical 70% of the time. Worse: when a client wants to switch from Anthropic to OpenAI 3 months later, you're back rewriting auth + retry + fallback logic.
- **With Skrun:** same skill format, deploy per client. Model swap is a YAML edit. Your client gets a stable `POST /run` endpoint **they own** — they can host on their infra, swap models, take over anytime. You ship the skill, not a server you maintain.
- ---
- ## 💬 What would *you* deploy?
- What skill would you turn into an API tomorrow? What's missing in your current agent setup?
- **[Tell us in Discussions](https://github.com/skrun-dev/skrun/discussions)** — we read every post, and it shapes what we build next.
- ---
- ## 🚀 Quick Start
- ```bash
- npm install -g @skrun-dev/cli
- skrun init --from-skill ./my-skill # or: skrun init my-agent
- skrun deploy -m "initial release" # build + push + get your API URL
- skrun verify dev/my-skill@1.0.0 # admin step — auto-admin in local dev
- skrun run dev/my-skill -i '{"query":"analyze this"}'
- ```
- That's it. Your agent is verified, callable via the CLI, and reachable as a `POST /run` HTTP endpoint:
- ```bash
- curl -X POST http://localhost:4000/api/agents/dev/my-skill/run \
- -H "Authorization: Bearer dev-token" \
- -H "Content-Type: application/json" \
- -d '{"input": {"query": "analyze this"}}'
- ```
- > `dev-token` is for local development. In production, authenticate via [GitHub OAuth or API keys](docs/api.md#authentication) — your GitHub login becomes your namespace by default, and `skrun verify` is governed by the operator [verification policy](docs/self-hosting.md#verification-policy) (admin-only by default; creators can self-attest under `owner`).
- → **[10-minute tutorial](docs/getting-started.md)** · **[Concepts](docs/concepts.md)** · **[API reference](docs/api.md)**
- ---
- ## 📊 Dashboard
- <p align="center">
- <img src="docs/assets/dashboard/home.png" alt="Skrun Operator Dashboard — Home" width="900">
- </p>
- Every Skrun registry ships with a full operator dashboard at `/dashboard`. No separate install, no extra env var.
- - **Home** — workspace stats, 24h/7d toggles, the account's usage of the server's quotas, recent activity, top agents.
- - **Agents** — sortable list with run counts, token usage, verification status.
- - **Agent detail** — per-agent metrics, versions with notes, metadata, try-it curl.
- - **Runs** — every execution across all agents, filterable by agent/ID/status/model.
- - **Run detail** — full I/O, tokens, cost, model, event timeline (tool calls, LLM calls).
- - **Playground** — call any agent interactively, watch SSE events live, save outputs.
- - **Settings** — profile + API keys (`skrun_sk_…`) with one-shot reveal, revocation, and a per-key expiry (or none).
- → **[Screenshot tour of all 7 pages](docs/getting-started.md#6-explore-the-dashboard)**
- ---
- ## 📦 SDK
- ```bash
- npm install @skrun-dev/sdk
- ```
- ```typescript
- import { SkrunClient } from "@skrun-dev/sdk";
- const client = new SkrunClient({
- baseUrl: "http://localhost:4000",
- token: "dev-token",
- });
- // Sync — get the result
- const result = await client.run("dev/code-review", { code: "const x = 1;" });
- console.log(result.output);
- // Stream — real-time events
- for await (const event of client.stream("dev/code-review", { code: "..." })) {
- console.log(event.type); // run_start, tool_call, llm_complete, run_complete
- }
- // Async — fire and forget with webhook callback
- const { run_id } = await client.runAsync("dev/agent", input, "https://your-app.com/hook");
- // Pin a specific agent version — reproducible, no silent drift
- const pinned = await client.run("dev/code-review", input, { version: "1.2.0" });
- console.log(pinned.agent_version); // "1.2.0" — always echoed back
- // Push with a note (like a git commit message)
- await client.push("dev/code-review", bundle, "1.3.0", { message: "Added retry logic" });
- ```
- 10 methods: `run`, `stream`, `runAsync`, `push`, `pull`, `list`, `getAgent`, `getVersions`, `verifyVersion`, `setVisibility`. **Zero runtime dependencies**, Node.js 22+.
- ---
- ## ✨ Features
- | Feature | Description |
- |---------|-------------|
- | 🤖 **Multi-model** | 6 built-in providers (Anthropic, OpenAI, Google, Mistral, Groq, xAI) + any OpenAI-compatible endpoint (DeepSeek, Kimi, Qwen, Ollama, vLLM…) — with automatic fallback |
- | 🔧 **Tool calling** | Local scripts (`scripts/`) + MCP servers (`npx`) — same ecosystem as Claude Desktop |
- | 💾 **Stateful** | Agents remember across runs via key-value state — one notebook per caller by default |
- | 📡 **Streaming** | SSE real-time events (`run_start` → `tool_call` → `run_complete`) + async webhooks |
- | 📦 **Typed SDK** | `npm install @skrun-dev/sdk` — `run()`, `stream()`, `runAsync()` + 7 more methods |
- | 📊 **Operator Dashboard** | Web UI at `/dashboard` — agents, runs, stats, settings, integrated playground with SSE streaming |
- | 📖 **Interactive API docs** | OpenAPI 3.1 schema + Scalar explorer at `GET /docs` |
- | 🔐 **Production auth** | GitHub OAuth login + API keys (`skrun_sk_…`) + multi-tenant namespaces |
- | ⚖️ **Per-account quotas** | Off until the operator sets them, [per plan](docs/self-hosting.md#quotas-per-plan): an account's runs in progress and its compute time per window, a cap on the runs the whole instance holds at once — the lever that bounds what runs cost —, a longest timeout, and an account's bundle storage and live uploads, checked at the push and at the upload. A refused run gets a typed `429` / `503` / `400` with `Retry-After`, and the account's full-access credentials see its numbers in `X-Quota-*` headers and read them at any time from `GET /api/usage` (`client.usage()` in the SDK); with a pre-warm pool, a plan also sets how many runs an hour are entitled to a ready machine. An admin assigns an account's plan with one request |
- | 🗄️ **Persistent storage** | Pluggable database — SQLite for local dev (zero-config, file-based), any standard Postgres for production (Supabase, Neon, RDS, Fly Postgres… — no vendor lock-in) |
- | 🔑 **Caller keys** | Users bring their own LLM keys via `X-LLM-API-Key` — zero cost for operators. A key only ever goes to an endpoint its **owner** chose: an agent may declare its own `model.base_url`, so running someone else's agent with your key for its primary model means naming the origin you expect (`X-LLM-Base-URL`), and the server never pairs its own key with an agent-chosen endpoint unless the operator opts in |
- | ✅ **Agent verification** | Per-version verified flag, governed by the operator's [verification policy](docs/self-hosting.md#verification-policy): by default an unverified version cannot run at all, so an admin vets each version before any caller uses it; under `owner`, creators attest their own |
- | 🔒 **Private by default** | Every agent is `private` — only its owner/admin can `POST /run`; non-owners get an opaque 404 and can't override the agent's declared environment. Agents are private-only for now — setting one `public` is disabled |
- | 📌 **Version pinning + notes** | Pin a specific agent version per call (`version: "1.2.0"`) or attach a note at push (`-m "..."`) — reproducible integrations, visible changelog |
- | 🌍 **Environment separation** | Agent behavior (model, tools) separated from runtime environment (networking, timeout, cost cap). Per-run overrides via POST /run body |
- | 📁 **Files API** | Unified `/api/files` namespace for both directions — upload binary inputs (image/PDF/audio) via `POST /api/files`, download agent-produced artifacts via `GET /api/files/:id/content` |
- | 🖼️ **Multimodal inputs** | Declare `type: file` inputs (image / PDF / audio) in `agent.yaml`. Agents read images directly via vision (no OCR upstream). 3 transports: file_id ref, base64 inline, URL. Capability check at `skrun deploy/push` refuses incompatible model+media. |
- | 📦 **Script dependencies** | Drop a standard `package.json` (Node) or `requirements.txt` / `pyproject.toml` (Python) at the bundle root. Skrun installs them where your scripts run: a server that runs them itself resolves deps on first run and caches them at `~/.skrun/deps/<hash>/` for instant subsequent runs; the cloud sandbox installs them as each run starts. Auto-detects pnpm/yarn/npm + uv/poetry lockfiles for reproducible installs (npm only in the cloud sandbox). |
- | 🎯 **Tool choice** | Force the LLM to invoke a specific tool (top-level `tool_choice: <name>`), require any tool (`tool_choice: required`), block tool use (`none`), or mark per-tool invariants with `required: true`. Native cross-provider support (Anthropic / Gemini / OpenAI / xAI) with graceful soft-fallback when a directive isn't natively supported. |
- | 💸 **Native prompt caching** | Automatic across all 6 providers (Anthropic / OpenAI / Gemini / xAI / Groq / Mistral) — 30-90% input cost savings on repeated content (system prompts + tools + reference documents). Anthropic gets explicit `cache_control` injection on the system + tools prefixes, and on the conversation as a tool loop grows; OpenAI / Mistral / xAI / Groq / Gemini benefit from implicit caching. Cost-tracking accuracy improves to ±5% of provider invoice via the new `cache_read_tokens` / `cache_write_tokens` fields in `usage`. Track dollar savings live (`cost.saved`) and on the dashboard. |
- | 📊 **Structured logs** | JSON to stdout via pino — pipe to Axiom, Datadog, ELK. `LOG_LEVEL` env var controls verbosity |
- | ☁️ **Cloud deployment** | `SKRUN_RUNTIME=flyio` spawns a dedicated ephemeral sandbox machine per run. The harness drives the LLM loop and holds every credential; the sandbox runs agent code with zero LLM/DB/S3 keys, as a non-root UID with zero capabilities, behind an iptables egress allowlist; its root filesystem is writable, and each machine serves a single run. Self-host `docker-compose` applies container-level hardening (read-only rootfs, non-root, cap-drop, no-new-privileges); the per-run micro-VM + zero-credential sandbox are cloud-only (self-host runs agents in-process). |
- ---
- ## 🧪 Demo agents
- Fourteen runnable demos under [`agents/`](./agents/). The eight below each produce a real, downloadable artifact (PDF, XLSX, PPTX, ZIP, CSV, MD); the six others — code-review, data-analyst, email-drafter, pdf-processing, seo-audit, web-scraper — answer in the run's output. All use Google's Gemini 3.8 Flash by default (free tier), with Gemini 3.5 Flash-Lite as fallback. Change the `model` section in `agent.yaml` to use any [supported provider](#-features).
- ### For OSS developers
- | Agent | What it does | Artifact |
- |-------|--------------|----------|
- | 📝 [changelog-generator](agents/changelog-generator/) | Reads your local `git log` between two tags, groups commits by Conventional Commit type, drafts release notes | `CHANGELOG.md` + `release-notes.md` |
- | 📐 [adr-writer](agents/adr-writer/) | Captures an architectural decision (context / options / decision / consequences) as a numbered Markdown ADR — auto-numbers from your existing `adrs/` folder | `NNNN-<slug>.md` |
- ### For internal-platform / engineering teams
- | Agent | What it does | Artifact |
- |-------|--------------|----------|
- | 🎯 [meeting-transcript-to-action-items](agents/meeting-transcript-to-action-items/) | Extracts decisions + action items from a Zoom/Teams transcript. **Stateful** — auto-resolves prior actions when next meeting mentions them as done | `actions.csv` + `recap.md` |
- | 🛡️ [semgrep-rule-creator](agents/semgrep-rule-creator/) | Turns a CVE description + bad-code snippet into a complete Semgrep rule bundle (rule + tests + rationale) | `rule.yml` + `tests.md` + `README.md` |
- ### For freelancers / analysts / biz operators
- | Agent | What it does | Artifact |
- |-------|--------------|----------|
- | 📊 [csv-to-executive-report](agents/csv-to-executive-report/) | CSV → analyzed multi-page PDF with charts + narrative + summary table | `report.pdf` |
- | 🎤 [slide-deck-generator](agents/slide-deck-generator/) | Markdown outline → polished `.pptx` with brand color, title/content/closing layouts, speaker notes | `deck.pptx` |
- | 🧾 [receipts-to-expenses](agents/receipts-to-expenses/) | Receipt photos (vision-native) + optional bank statement → categorized expense workbook + summary PDF | `expenses.xlsx` + `monthly.pdf` |
- ### Universal
- | Agent | What it does | Artifact |
- |-------|--------------|----------|
- | 🧠 [knowledge-base-from-vault](agents/knowledge-base-from-vault/) | Folder of Markdown notes (Obsidian/Notion/raw) → navigable static HTML site. **Stateful** — concept index densifies across runs | `kb.zip` (HTML+CSS) |
- <details>
- <summary><b>Earlier minimal demos</b></summary>
- Shorter examples that each illustrate one primitive (model fallback, MCP, state, scripts) without producing artifacts:
- [code-review](agents/code-review/) · [pdf-processing](agents/pdf-processing/) · [seo-audit](agents/seo-audit/) · [data-analyst](agents/data-analyst/) · [email-drafter](agents/email-drafter/) · [web-scraper](agents/web-scraper/)
- </details>
- <details>
- <summary><b>Try one locally</b></summary>
- ```bash
- # 1. Start the registry (uses SQLite — data persists across restarts)
- cp .env.example .env # add your GOOGLE_API_KEY
- pnpm dev:registry # keep this terminal open
- # 2. In another terminal — pick any agent (changelog-generator is the lightest)
- skrun login --token dev-token
- cd agents/changelog-generator
- skrun build && skrun push -m "v1 — first push"
- skrun verify dev/changelog-generator@0.3.1 # admin step; dev-token = auto-admin
- # 3. Call it (uses the bundled fixture — no real git repo needed)
- skrun run dev/changelog-generator \
- -i '{"repo_path": "./fixtures/sample-repo.git-log.txt", "project_name": "demo"}'
- # Or via raw HTTP:
- curl -X POST http://localhost:4000/api/agents/dev/changelog-generator/run \
- -H "Authorization: Bearer dev-token" \
- -H "Content-Type: application/json" \
- -d '{"input": {"repo_path": "./fixtures/sample-repo.git-log.txt", "project_name": "demo"}}'
- # 4. Download the artifacts via the Files API (run_id from response)
- curl http://localhost:4000/api/runs/<run_id>/files/CHANGELOG.md \
- -H "Authorization: Bearer dev-token" -o CHANGELOG.md
- ```
- > **Windows (PowerShell):** use `curl.exe` instead of `curl`, and pass `-d "@input.json"` for the body.
- > **Python demos** (slide-deck-generator, csv-to-executive-report, receipts-to-expenses) and the **Node demo** (knowledge-base-from-vault): no manual install. The local registry resolves each agent's `requirements.txt` / `package.json` on its first call and caches the result on this machine, at `~/.skrun/deps/<hash>/`. See the [Script dependencies](docs/agent-yaml.md#script-dependencies) reference.
- </details>
- ---
- ## 💻 CLI
- | Command | Description |
- |---------|-------------|
- | `skrun init [dir]` | Create a new agent |
- | `skrun init --from-skill <path>` | Import existing skill |
- | `skrun dev` | Local server with POST /run (mock, free) |
- | `skrun test` | Check tests against simulated outputs (no model call) |
- | `skrun build` | Package `.agent` bundle |
- | `skrun push -m "note"` | Push with a version note |
- | `skrun verify <ns>/<name>@<v>` | Attest a version (authority per the verification policy — admin by default) |
- | `skrun unverify <ns>/<name>@<v>` | Revoke verification (authority per the verification policy) |
- | `skrun run <ns>/<name>[@<v>]` | Invoke an agent — `-i` inline, `-f` file, `--stdin` pipe |
- | `skrun deploy -m "note"` | Build + push + run URL |
- | `skrun pull <agent>` | Download agent bundle |
- | `skrun keys create --name <key-name> --agent <ns>/<name> --run-only` | Mint a scoped/restricted API key (e.g. a run-only client key) |
- | `skrun llm-key set <provider> --agent <ns>/<name>` | Attach your LLM key so callers run the agent on your key (key from stdin / `--key-env`) |
- | `skrun login --registry <url>` / `logout` | Sign in to a server, which the CLI then remembers (OAuth or token); sign out of it |
- | `skrun logs <agent>` | Execution logs (planned) |
- → **[Full CLI reference](docs/cli.md)**
- ---
- ## 🌐 Self-hosting
- Skrun is MIT — deploy anywhere.
- Recommended: the prod-parity Docker Compose stack (Postgres + MinIO + Redis + Caddy) — follow its **[quick start](docs/self-hosting-docker.md#quick-start)**.
- - 🐳 **Docker Compose** — `docker compose up` brings the prod-parity stack (Postgres + MinIO + Redis + Caddy) live with every sandbox hardening control on by default. See **[self-hosting with Docker](docs/self-hosting-docker.md)**.
- - **SQLite (bare-metal)** — zero config, file-based, survives restarts. Good for local dev and single-node.
- - **Postgres** — production-grade. Any host works (Supabase, Neon, RDS, Fly Postgres…) via `DATABASE_URL=postgres://…`. No vendor lock-in.
- - **Any cloud** — Fly.io, AWS, GCP, Hetzner, bare metal. Caddy or nginx in front.
- - **GitHub OAuth** — users sign in with GitHub; their login becomes their namespace by default (`<login>--2` if it is taken).
- → **[Self-hosting guide](docs/self-hosting.md)** — step-by-step with env vars, reverse proxy, migrations.
- ---
- ## 📚 Documentation
- - 📖 **[Getting Started](docs/getting-started.md)** — 10-minute tutorial with dashboard screenshots
- - 🧠 **[Concepts](docs/concepts.md)** — vocabulary reference (agent, skill, run, namespace…)
- - 🌐 **[Self-hosting](docs/self-hosting.md)** — deploy on your own infrastructure
- - 🔧 [agent.yaml](docs/agent-yaml.md) · [CLI](docs/cli.md) · [API](docs/api.md) — full references
- - 🎮 [Interactive API explorer](http://localhost:4000/docs) — live Scalar UI (start the registry first)
- - 📋 [OpenAPI schema](http://localhost:4000/openapi.json) — import into Postman / Insomnia
- - 📝 [Changelog](CHANGELOG.md) · 🤝 [Contributing](CONTRIBUTING.md)
- ---
- ## 👥 Community
- - 💬 [GitHub Discussions](https://github.com/skrun-dev/skrun/discussions) — ask questions, share agents
- - 🐛 [Issues](https://github.com/skrun-dev/skrun/issues) — report bugs, request features
- - ⭐ [Star the repo](https://github.com/skrun-dev/skrun) if you like the project!
- ---
- ## 🤝 Contributing
- ```bash
- git clone https://github.com/skrun-dev/skrun.git
- cd skrun
- pnpm install && pnpm build && pnpm test
- ```
- See [CONTRIBUTING.md](CONTRIBUTING.md) for conventions and setup.
- ---
- ## 📜 License
- [MIT](LICENSE) — free to use, modify, self-host, and build on top.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.