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.