by.waclaw.online / agent-operator

The Agent as Operator

How to turn a coding agent — Claude Code, Codex, Pi, or any of their cousins — into a delegated operator that runs your real work against external systems, through a documented, authenticated tool belt of small CLI scripts.

The one-sentence idea

A coding agent is very good at reading instructions, calling tools, and reasoning about what to do next. If you give it a set of small, well-documented command-line tools that talk to a real system as you, your workstation becomes an automated operator that does your work — not a chatbot that talks about it.

This guide builds that idea from first principles to a concrete reference implementation. We do not stop at theory: we design a working operator for an eBay seller business, define its tool belt, and write the soul.md that gives it judgment. We deliberately stop short of the tools' source code — the valuable, durable artifacts are the architecture, the contracts, and the operating instructions, not a hundred lines of Python that will be stale by next quarter.

Who this is for

This guide is written in two layers:

Chapters are tagged concept or build so you can read the layer you need.

The series

  1. The Concept: Your Workstation as a Delegated Operator concept
  2. Why CLI Tools, Not Raw API Calls concept
  3. Acting as the User: Authentication, Identity, and Trust concept
  4. Anatomy of an Orchestration Tool build
  5. soul.md: Giving the Agent Judgment concept
  6. Skills: From One-Off to Shared Capability concept
  7. Worked Example: Running an eBay Seller Operation build
  8. The Tool Catalog and Governance concept
  9. What's Next: From Chat to Scheduled Loops concept
A note on recency. Coding agents and the APIs they orchestrate both move quickly. Tool names, agent features, and a marketplace's exact endpoints will drift from what is written here. Treat the shape of the pattern as stable — small authenticated CLI tools, a persistent soul.md, shared skills — and check current API and Terms-of-Service details with the provider before you ship.