@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

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