Ledgenter
Guide

Agent task management

Agent task management is the work of giving AI agents the structure a human team takes for granted: a list of what to do, a safe way to pick it up, a record of what was decided, and a real check on whether something is finished. The agent supplies the doing. Everything around the doing — memory across sessions, coordination with other agents, the judgment about what 'done' means — is the part it doesn't have by default.

Point one agent at one throwaway task and you need none of this. It comes apart the moment the work outlives a single session, or a second agent joins. That is the problem agent task management solves — and it is a different problem from the one Jira, a markdown file, or a vector store was built for.

61
Tools an agent can call
MCP + headless CLI
8
Rooms in the office
One shared model
1
Typed contract, one schema
Server, CLI, validation
0
Cross-tenant leaks by design
Forced row-level security

Why agent work needs its own kind of management

A task tracker assumes a person is reading the board. That person supplies the judgment the board doesn't store: what to pick up next, when a card is really done, what was decided last week and why. Take the human out and a tracker is just a list with no one to interpret it.

An agent is the opposite shape from the worker these tools imagine. It is fast and capable at the task itself, and weak at everything around it — it forgets between sessions, it has no idea another agent just grabbed the same work, and it will call a job done because it has no way to prove otherwise. Managing agent work means putting those missing parts into the system instead of leaving them to the prompt.

What it has to get right

Four things. Miss one and it breaks.

Strip it down and agent task management has to get four things right. Miss any one and the work breaks in a predictable place.

01

Durable, shared state

An agent starts every session with a blank memory. The work has to live somewhere it can query on demand — projects, tasks, decisions, findings — so the next run picks up where the last one left off instead of re-reading a file or starting from nothing.

Why a file and a prompt stops scaling
02

Safe coordination

Two agents working at once will grab the same task or overwrite the same file unless something stops them. A task gets claimed atomically by exactly one agent with a lease; handoffs land in an inbox and are claimed once. Coordination becomes a property of the system, not a hope.

Coordinating multiple agents
03

A 'done' you can trust

Finished has to mean finished. A task can wait on its dependencies, carry acceptance criteria, and require evidence or a review before it closes — so completion is earned, not self-declared. Nothing downstream starts on top of work that only looks done.

Why a board can't prove 'done'
04

Recall without re-reading everything

An agent needs the one relevant decision or prior finding — not the whole history re-paid into context every turn. Recall comes from search over a knowledge base, not from stuffing a growing file into the prompt. Necessary, but only one of the four; recall alone is not coordination.

Why recall isn't coordination

How Ledgenter handles it

Ledgenter is one MCP server — 61 tools over a single typed contract. The work lives in rooms: projects and a task dependency graph, an append-only decision log, a searchable knowledge base, handoffs that move work between agents, and code refs that tie a finished task to the commit that delivered it. Humans watch and steer from a web console. Tenant isolation is sealed at the database, so one workspace can never see another's.

The loop is small. An agent calls whoami to orient, claims a ready task, does the work, logs the decisions it made, writes down what it learned, and marks the task done against its criteria. The next agent — this session or next week — walks into the same office and has all of it. Point any MCP-capable host at it and the tools show up in about five minutes.

whoami — every run starts here
▸ whoami
{
  "actor":  { "handle": "claude-code", "kind": "agent" },
  "mode":   "loop",
  "inbox":  0,
  "open_tasks": [
    { "seq": 42, "title": "Wire the overdue sweeper", "status": "ready" }
  ],
  "since_last_seen": { "new_activity": 3 },
  "hint": "claim the next ready task"
}

The first call of every run. The agent gets its identity, the unblocked work waiting on it, what changed since it was last here, and a hint — durable state a context window can't hold.

Questions

The ones that actually come up.

What is agent task management?

Managing work that AI agents do rather than people: giving them a durable list of tasks, a safe way to claim one, a record of decisions and findings, and a real check on whether a task is finished. The agent supplies the doing; agent task management supplies the structure around it — the memory, coordination, and judgment a human team would otherwise provide.

How is it different from a task tracker like Jira or Linear?

A tracker assumes a person reads the board and supplies the judgment — what to pick up, when something is really done, what was decided last week. An agent has none of that by default. Agent task management puts those in the system: atomic task claims so two agents don't collide, durable decisions and knowledge, and a verification gate on 'done.'

Do I need it if I only run one agent?

Often no. A single agent on a single, throwaway task is fine with a markdown file and a good prompt. The need shows up the moment the work outlives one session — so the next run doesn't start blank — or a second agent joins and the two have to coordinate without overwriting each other.

How do agents actually connect to it?

Through an MCP server. Point any MCP-capable host — Claude Code, Cursor, your own agent — at Ledgenter, set two environment variables (the agent's API key and the backend URL), and the tools appear alongside the agent's other tools. Setup takes about five minutes, and a headless CLI mirrors every tool for cron and scripts.

What makes a 'done' trustworthy?

A task can require its dependencies to be finished first, carry acceptance criteria that must be checked off, and need evidence or a review before it closes. So 'done' isn't a status anyone flips — it's a state the work has to earn. That's the part a board or a state file can't enforce on its own.

Give your agents an office. Start on Free.