@tiwater/supen

@tiwater/supen

Supen CLI for bootstrapping a local Supen daemon, managing agents and skills, and chatting with your local runtime from the terminal.

Install

npm install -g @tiwater/supen

After install, the binary is available as:

supen

Quick Start

The easiest first run is:

supen bootstrap

That walks through initial setup, writes ~/.supen/config.yaml, and prepares the local daemon/service setup.

If you want to configure models manually instead:

supen model add minimax <api-key>
supen model set minimax:MiniMax-M2.7
supen doctor

Common Commands

Interactive REPL

Run supen with no arguments to open the interactive chat REPL:

supen

One-shot Chat

supen chat "hi"
supen chat --agent web-agent --session <session-id> "continue"
supen chat --json "status"

Daemon Management

supen daemon install
supen daemon status
supen daemon logs --lines 100
supen daemon update

Health Checks

supen doctor
supen doctor list
supen doctor run

Models

supen model list
supen model add openai <api-key>
supen model set openai:gpt-4.1
supen model remove openai

Skills

supen skills list
supen skills install <git-url-or-name>
supen skills enable <name>
supen skills inspect <name>

Agents and Sessions

supen agent list
supen agent create research-agent
supen session list
supen session show <session-id>

Config

supen config list
supen config get default_model
supen config set gateway.url https://gateway.example.com
supen config delete gateway.url

Files and Paths

Supen CLI uses the local Supen home directory:

• config: ~/.supen/config.yaml
• auth: ~/.supen/auth.json
• agents and workspaces: ~/.supen/agents

Isolated environments (dev vs test)

The local daemon stores state under SUPEN_HOME and now also reads:

• SUPEN_DAEMON_CONTAINER_NAME (default: supen-daemon)
• PORT (default: daemon port from config or 2756)

Example dev profile:

SUPEN_HOME=$HOME/.supen-dev \
PORT=2756 \
SUPEN_DAEMON_CONTAINER_NAME=supen-daemon-dev \
supen daemon install

Example isolated test profile:

SUPEN_HOME=$(mktemp -d) \
PORT=3760 \
SUPEN_DAEMON_CONTAINER_NAME=supen-daemon-test \
supen daemon install

Optional helper scripts are available:

./scripts/supen-dev.sh daemon install
./scripts/supen-test.sh daemon install

Typical Local Flow

supen bootstrap
supen doctor
supen daemon status
supen

Or, for scriptable use:

supen chat --json "summarize the current project"

Help

Every command supports --help:

supen --help
supen chat --help
supen daemon --help
supen skills --help

Source

• repo: https://github.com/tiwater/supen
• issues: https://github.com/tiwater/supen/issues