Agent skill

shell

CLI interactive mode channel. Delivers Claude responses to the zylos shell REPL via Unix socket.

View SKILL.md on GitHub Repository
Stars 1,038
Forks 113

Install this agent skill to your Project

npx add-skill https://github.com/zylos-ai/zylos-core/tree/main/skills/shell

SKILL.md

Shell Channel

Communication channel for zylos shell — the CLI interactive mode.

How It Works

  1. zylos shell starts a readline REPL and a Unix domain socket server
  2. User input is sent to Claude via c4-receive (channel=shell, endpoint=socket path)
  3. Claude responds via c4-send which invokes scripts/send.js
  4. send.js connects to the Unix socket and delivers the response to the REPL
  5. The REPL prints the response and prompts for the next input

Socket Protocol

  • Socket path is passed as the endpoint (e.g., /tmp/zylos-shell-<pid>.sock)
  • send.js connects, writes the full message as UTF-8, then closes the connection
  • The REPL reassembles the message from socket data events

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

zylos-ai/zylos-core

web-console

Built-in web interface for communicating with Claude without external services. Use when setting up or configuring the web console channel, or troubleshooting browser-based access.

1,038 113
Explore
zylos-ai/zylos-core

component-management

Guidelines for managing zylos components via CLI and C4 channels. Use when installing, upgrading, or uninstalling components, or when user asks about available components.

1,038 113
Explore
zylos-ai/zylos-core

restart-claude

Use when the user asks to restart Claude Code, or after changing settings/hooks/keybindings.

1,038 113
Explore
zylos-ai/zylos-core

comm-bridge

C4 communication bridge — central gateway for ALL external communication (Telegram, Lark, etc.). Use when replying to users via the "reply via" path, sending proactive messages to external channels, querying recent conversations or checkpoint status (prefer c4-db.js CLI; sqlite3 OK for unsupported queries), fetching conversation history for Memory Sync, or creating checkpoints after sync. Incoming messages are queued by channel bots and delivered to Claude via a PM2 dispatcher daemon. Session-start hooks automatically provide conversation context and can trigger Memory Sync when unsummarized conversations exceed the configured threshold.

1,038 113
Explore
zylos-ai/zylos-core

new-session

Start a new session when context is high. Claude uses /clear, Codex uses /exit. Use when context is high or when a fresh session is needed.

1,038 113
Explore
zylos-ai/zylos-core

http

Caddy-based web server providing web console hosting, file sharing, and health check endpoints. Use when configuring HTTP access, setting up file sharing, or troubleshooting web connectivity.

1,038 113
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results