ikigai-ctl

Interact with a running ikigai instance via its Unix domain control socket.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Provides a simple CLI client to interact with a running ikigai server via a Unix domain socket, enabling automation, testing, and tooling.

Core Features & Use Cases

  • Auto-discovery of the ikigai control socket when not specified.
  • Supported requests: read_framebuffer and send_keys, with planned future messages.
  • Works with both development and production runtime path conventions for the socket.

Quick Start

Invoke ikigai-ctl with a message type to interact with a running ikigai instance, optionally specifying the socket path.

Frequently Asked Questions about ikigai-ctl

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

FAQPage Schema
How do I automate interactions with a running ikigai instance from external scripts?

The ikigai control socket uses a newline-delimited JSON protocol for communication. External scripts send JSON-formatted request messages, such as read_framebuffer or send_keys, through the Unix domain socket to programmatically control the instance.

How do I locate the Unix domain socket path for ikigai automation?

You can locate the Unix domain socket path by relying on the CLI's auto-discovery feature when the path is not explicitly specified. It automatically resolves the correct socket location by checking both development and production runtime path conventions.

What requests can I send to ikigai through the control socket?

Currently supported requests include read_framebuffer and send_keys, which allow you to inspect screen state and simulate input. Additional messages are planned for the roadmap to expand the available automation and testing tooling capabilities.

Does ikigai-ctl require any external dependencies to control the socket?

No external dependencies are required to control the socket. The Skill operates using standalone scripts, meaning you can integrate it into your automation and testing tooling workflows without installing additional libraries or packages.

Can I use this socket control approach for both development and production environments?

Yes, you can use this socket control approach for both development and production environments. The CLI client supports auto-discovery and works with both development and production runtime path conventions for the Unix domain socket.