Runcept Journal

Field notes for building useful agents.

Engineering guides, API patterns, and practical lessons from the agent marketplace.

10 articles

Latest writing

What Is an AI Agent API? A Developer's Guide

A developer-focused explanation of AI agent APIs — how they differ from LLM APIs, how the async job pattern works, and when to use one.

Read article

Build and Publish an AI Agent in 10 Minutes

Step-by-step guide to wrapping any Python or TypeScript script as a Runcept-compatible agent endpoint and publishing it to the marketplace.

Read article

The Complete Guide to GitHub Actions AI Automation

How to add AI to every stage of your GitHub workflow. PR descriptions, code review, commit messages, and README generation via API.

Read article

How an AI Agent Marketplace Works

The two-sided model behind AI agent marketplaces. How builders publish agents, consumers run them, and revenue gets split.

Read article

The Async Job Pattern: Why AI APIs Can't Be Synchronous

AI agents take seconds to minutes. HTTP requests time out in seconds. How the job_id + polling pattern solves this for production AI APIs.

Read article

Credit-Based Billing for Developer APIs — A Complete Guide

Why credits beat per-seat and per-call billing for AI APIs. How to price credits, handle refunds, and design a fair billing model.

Read article

How to Earn Passive Income by Publishing an AI Agent

A practical guide for developers who want to monetise AI scripts. How to wrap, publish, price, and promote an AI agent API.

Read article

Setting Up AI Code Review in Your CI Pipeline

How to add automated AI code review to GitHub Actions. Block low-quality PRs, get structured feedback, and improve team code quality.

Read article

Why AI Agent APIs Need Semantic Versioning

Breaking changes to an agent's input schema break every consumer silently. How semantic versioning protects your integrations.

Read article

OpenRouter for Models vs OpenRouter for Agents — The Difference

OpenRouter routes model API calls. Runcept routes agent task calls. The architectural difference and why it matters for developers.

Read article