agents

Ready-to-use agents

Repeatable procedures your AI agent runs with judgment. Every run writes a trace. The agent gets better over time.

Anatomy of an agentmodules/my-agent/
index.mdmanifest
steps/
1-collect.md
2-process.md
commands/
setup.md
runs/
1/
1-collect/
results.md
2-process/
results.json
done/
info.md
(other)
How a run works
1
Read index.md
Learn the purpose
2
Read steps
Load all instructions
2a
1-collect.md
2b
2-process.md
3
Run steps
Execute and report
3a
1-collect.md
3b
2-process.json
4
Done
Report to user

What is a context-based agent

An agent is a folder of markdown files that an AI runtime follows. It has steps, a setup command, and a runs/ folder where every execution writes its trace. The agent reads past runs before it starts a new one, so it makes better decisions each time.

This is not a prompt chain or a static runbook. The steps give the agent room for judgment: they say what to accomplish and when the step is done, not which API call to make. The result is a procedure that works across different systems because the agent adapts it.

Every agent declares two kinds of inputs:

  • connections are the services the agent talks to (an API, a database, a platform). You map them once at setup, and the agent uses them for every run.
  • parameters are the values you give when you start a run: the scope, the target, the input for that execution. They change each time.
terminal
$ gcontext add coolify-ops
gcontext - installed Coolify Ops (12 files) at modules/coolify-ops/
Next step: personalize it. Tell your agent to run the setup in
modules/coolify-ops/commands/setup.md

How runs build on each other

The first run starts from the procedure alone. It syncs data, operates, and writes what happened into runs/1/. The second run reads that trace before it begins. If the first run discovered a retry pattern, the second run knows about it and applies it.

Playbooks, decision logs, and checklists accumulate inside the module. The agent consults them before every step. Nothing is retrained, no model is fine-tuned. The context is just files, and the agent reads them.

run trace
$ Run the coolify-ops agent
Syncing deployments from Coolify API...
Found 3 new deployments since last run.
Updated playbooks/deploy-checklist.md with retry pattern.
Writing trace to runs/2/
runs/2/1-sync/results.md (deployment mirror)
runs/2/2-operate/results.md (actions taken)
runs/2/done/info.md (run summary)

Anatomy of an agent folder

Every agent follows the same structure. A manifest, numbered steps, a place for runs, and optional commands and functions.

agent folder
📄
index.md

Manifest with metadata, description, parameters, and connection requirements.

📋
steps/

Numbered markdown files the agent follows, each with a clear objective and done condition.

🗂
runs/

Traces from completed runs. The agent reads past runs to make better decisions.

⚙️
commands/

Setup interview and user-invokable actions. The setup command personalizes the agent.

anything else/

Functions, playbooks, checklists, templates. Add whatever folders the agent needs. The structure is yours.

How to add an agent

With gcontext

One command. The agent lands in your instance's modules/ folder, ready for the setup interview.

$ gcontext add coolify-ops

Without gcontext

Every agent is a plain folder of markdown files. Download it from the agent page and drop it into any instance. No lock-in, no runtime dependency.

Published agents

Browse all →
Browser Recipes13 files

Explore browser actions with AI, then crystallize them into reusable Python scripts. Recipes self-heal: when a script fails, the agent falls back to live exploration and updates the recipe.

automationbrowser
gcontext add browser-recipes
Release Ops19 files

A release agent that collects changes, drafts a changelog, bumps the version, publishes, and optionally announces. Each release is a searchable run; the agent learns your changelog style and known blockers over time.

releaseopsdevtools
gcontext add release-ops
SEO Content Pipeline14 files

Research keywords, discover content opportunities, and build a prioritized list of content ideas. Each run explores a seed topic and produces actionable suggestions, not finished articles.

seocontent
gcontext add seo-pipeline