Sigilum CLI
Website: https://sigilum.id CLI Tool: sigilum Repository: https://github.com/PaymanAI/sigilum Authentication: Dashboard pairing (session-id + pair-code)
Description
Sigilum lets AI agents access APIs without using personal API keys. Instead of sharing secrets, each agent gets its own credentials that can be approved or revoked from a dashboard. It provides a local gateway that handles authentication on behalf of agents, enabling secure API access with fine-grained control.
Install
curl -fsSL https://github.com/PaymanAI/sigilum/releases/latest/download/install-curl.sh | bash
source ~/.zshrc
Verify installation:
sigilum --help
Usage
First-Time Setup (OpenClaw/Claude Code)
Connect and set up with full installation (gateway, hooks, skills, agent keys):
sigilum openclaw connect \
--session-id <session-id-from-dashboard> \
--pair-code <pair-code-from-dashboard> \
--namespace <your-namespace> \
--api-url https://api.sigilum.id \
--lifecycle-mode stable
Normal Re-Pairing
For subsequent connections (after initial setup):
sigilum gateway connect \
--session-id <session-id-from-dashboard> \
--pair-code <pair-code-from-dashboard> \
--namespace <your-namespace> \
--api-url https://api.sigilum.id \
--lifecycle-mode stable
Check Status
# Check pairing status
sigilum gateway pair --status
# Health check
curl -fsS http://127.0.0.1:38100/health
Commands
| Command | Description |
|---|---|
sigilum --help |
Show help |
sigilum openclaw connect |
First-time setup with full installation |
sigilum gateway connect |
Re-pair with existing setup |
sigilum gateway pair --status |
Check pairing status |
Parameters
| Parameter | Description |
|---|---|
--session-id |
Session ID from Sigilum dashboard |
--pair-code |
Pairing code from Sigilum dashboard |
--namespace |
Your namespace/username |
--api-url |
API endpoint (default: https://api.sigilum.id) |
--lifecycle-mode |
Mode: stable, beta, etc. |
Examples
Initial Setup Flow
# 1. Install CLI
curl -fsSL https://github.com/PaymanAI/sigilum/releases/latest/download/install-curl.sh | bash
source ~/.zshrc
# 2. Get session-id and pair-code from dashboard
# 3. Connect (first time)
sigilum openclaw connect \
--session-id abc123-def456 \
--pair-code ABCD1234 \
--namespace myuser \
--api-url https://api.sigilum.id \
--lifecycle-mode stable
# 4. Verify
sigilum gateway pair --status
curl -fsS http://127.0.0.1:38100/health
Re-Pairing Flow
# Get fresh session-id and pair-code from dashboard first
sigilum gateway connect \
--session-id new-session-id \
--pair-code NEW1CODE \
--namespace myuser \
--api-url https://api.sigilum.id \
--lifecycle-mode stable
Notes
- Pair codes expire - always get a fresh pair-code from dashboard before pairing
- openclaw connect vs gateway connect:
- Use
openclaw connectfor first-time setup or reinstalling hooks/skills - Use
gateway connectfor normal re-pairing - Local gateway runs on
http://127.0.0.1:38100 - Dashboard - approve/revoke agent credentials from web interface
- Security model - agents get isolated credentials, no shared secrets
- Supported agents - OpenClaw, Claude Code, and other AI coding agents
Comments (0)
Add a Comment
No comments yet. Be the first to comment!