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.
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
# 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):
- Set
ZYLOS_WEB_PASSWORDin~/zylos/.env - 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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
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.
restart-claude
Use when the user asks to restart Claude Code, or after changing settings/hooks/keybindings.
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.
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.
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.
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".
Didn't find tool you were looking for?