Profile

Ikigai Devlog

AI-assisted development journal

Development Milestone 11

Agents can finally manage themselves. Rel-11 gives agents the tools to fork children, send messages, wait for results, and clean up after themselves without a human touching a single slash command.

Where We Are

Ikigai is an agentic AI terminal built from scratch in C. After eleven releases, the core platform looks like this:

What’s New in Rel-11

Agent Orchestration Primitives

This is the headline. We built a new internal tool infrastructure that supports both external (fork/exec) and internal (in-process C function) tools, then implemented four primitives on top of it:

PostgreSQL LISTEN/NOTIFY drives the communication layer. When an agent calls wait, it sleeps on a Postgres notification channel until its children report back. No polling, no busy loops.

The old mail system (five commands: send, check, read, delete, filter) is gone. Two primitives (send and wait) replaced all of it. The system prompt guides agents through the lifecycle: children complete their work, send results, and go idle. Parents manage everything through fork/wait/kill.

Template Processing for Pins

Pinned documents now support ${variable} template syntax. Variables resolve through four namespaces: ${agent.*}, ${config.*}, ${env.*}, and ${func.*}. Unresolved variables stay as literal text with a warning, so a missing variable won’t break your system prompt.

This means pinned system prompts can adapt to their context. An agent’s name, its configuration, environment variables, all of it flows into the system prompt at assembly time.

Ralph Pipeline Migration

We moved Ralph (our parallel agent orchestrator) from internal scripts to an external service backed by the ralph-plans API. The pipeline now manages goals through a full lifecycle: create, queue, start, done, stuck, retry, cancel. Goals support dependencies and FIFO scheduling with priority for untried work. Stories auto-close when all their goals finish.

The watch-ralphs terminal watcher gives a live view of running agents with flicker-free rendering and wrap-aware log tailing.

Source Tree Reorganization

We reorganized the source into apps/ikigai/, shared/, and tests/, with all includes using full paths from the project root. Cleaner boundaries, clearer ownership.

Claude Opus 4.6 Support

Ikigai now supports Claude Opus 4.6 with 128K thinking budget and adaptive thinking via effort parameters.

The Numbers

The source tree reorganization inflates these numbers considerably, since moving files counts as deleting and re-creating them. Still, the underlying work was substantial:

What’s Next

The orchestration primitives are working. The next step is putting them to real use, pushing the Ralph pipeline to handle increasingly complex multi-goal stories and seeing where the agent coordination model breaks down. We’re also looking at improving the template system and expanding what agents can do autonomously.


Co-authored by Mike Greenly and Claude Code