Agent skill

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.

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/web-console

SKILL.md

Web Console (C4 Built-in Channel)

Default communication channel - works without any external service.

Purpose

Allows users to communicate with Claude even without Telegram/Lark/Discord. This is the baseline, always-available interface.

Quick Start

bash
# Install dependencies
cd ~/zylos/.claude/skills/web-console
npm install

# Start server (default port 3456)
node scripts/server.js

# Or with PM2
pm2 start scripts/server.js --name web-console

Access

Local only: http://127.0.0.1:3456

Server binds to 127.0.0.1 by default for security.

Architecture

Browser ──► Web Console Server ──► C4 Bridge ──► Claude
                  │
                  ▼
               SQLite (c4.db)

API Endpoints

Endpoint Method Description
/api/status GET Get Claude's current status
/api/conversations/recent GET Get recent conversation history
/api/send POST Send message to Claude
/api/poll?since_id=N GET Poll for new messages
/api/health GET Server health check

Files

~/zylos/.claude/skills/web-console/
├── SKILL.md
├── package.json
├── scripts/
│   ├── server.js      # Express API server
│   └── send.js        # CLI message sender
└── public/
    ├── index.html     # Chat UI
    ├── styles.css     # Styling
    └── app.js         # Frontend logic

Environment Variables

Variable Default Description
WEB_CONSOLE_PORT 3456 Server port
ZYLOS_WEB_PASSWORD (empty) Set to enable password protection (also reads WEB_CONSOLE_PASSWORD as fallback)
WEB_CONSOLE_BIND 127.0.0.1 Bind address
ZYLOS_DIR ~/zylos Data directory

Authentication

By default, no password is required (suitable for local access).

To enable password protection (recommended when exposing externally):

  1. Set ZYLOS_WEB_PASSWORD in ~/zylos/.env
  2. Restart the web-console service

Features

  • Real-time status indicator (busy/idle/offline)
  • Message polling every 2 seconds
  • Auto-resizing input
  • Mobile-friendly responsive design
  • Dark theme

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

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
zylos-ai/zylos-core

health-check

System health check dispatched by the activity monitor via Control queue. Checks PM2 services, disk space, and memory usage. Use when receiving a control message containing "health-check".

1,038 113
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results