ikigai-ctl

Send protocol messages to a running ikigai instance via its control socket.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/mgreenly/ikigai --skill ikigai-ctl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ikigai-ctl
Source: https://github.com/mgreenly/ikigai/tree/main/.claude/library/ikigai-ctl
Command: npx skills add https://github.com/mgreenly/ikigai --skill ikigai-ctl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Control socket client for programmatic interaction with running ikigai

Core Features & Use Cases

  • CLI client for sending discrete protocol messages to a running ikigai instance.
  • Auto-discovery of the control socket or explicit path via --socket for scripting and tests.
  • Useful for agents, test harnesses, and external tooling that need programmatic access to ikigai state.

Quick Start

Invoke ikigai-ctl with a message type to query or manipulate the running ikigai instance.

Frequently Asked Questions about ikigai-ctl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control a running ikigai instance from the command line?▼

Control ikigai from the command line by launching ikigai-ctl to send protocol messages to the runtime socket, which returns a JSON response for programmatic interaction.

What is the control socket used for in ikigai automation?▼

The control socket in ikigai automation allows external tools and test harnesses to send discrete protocol messages, enabling programmatic access to query and manipulate the running ikigai state.

How do I specify the socket path when scripting ikigai-ctl commands?▼

Specify the socket path when scripting ikigai-ctl commands by using the explicit --socket flag, overriding auto-discovery to target a specific running ikigai instance for testing.

Does ikigai-ctl require a running instance to query automation state?▼

Yes, ikigai-ctl requires a running ikigai instance and access to its runtime control socket to launch client queries and return JSON responses for automation and testing.

Can I use ikigai-ctl for test harnesses and external tooling integration?▼

Yes, you can use ikigai-ctl for test harnesses and external tooling integration, as it provides a CLI client to send discrete protocol messages and retrieve JSON responses from the running instance.