vento-shell

Conversational terminal client for Vento networks and VentoChat agents.

Requirements

• Node.js 20 or newer
• Browser login opens the detected default Chromium-compatible browser and reads the Vento session token automatically after login. If the default browser cannot be detected or is not supported, vento-shell falls back to an installed Chrome, Chromium, Edge, or Brave. You can set CHROME_PATH to the browser executable when auto-detection cannot find it.

Local development

npm install
npm run build
npm link
vento-shell login
vento-shell

Commands

vento-shell
vento-shell login
vento-shell logout
vento-shell whoami
vento-shell agents
vento-shell ask "message"
vento-shell resume <session-id>
vento-shell sessions
vento-shell mode read-only|auto-edit|full-access
vento-shell doctor

Inside the interactive chat:

/help
/agent <name>
/mode read-only|auto-edit|full-access
/agents
/network
/new
/resume
/resume <session-id>
/sessions
/logout
/exit

Natural language input is sent to the current Vento agent. Sessions are stored locally in ~/.vento-shell/sessions and keep the VentoChat conversation id so follow-up messages stay in the same chat.

Build artifacts

dist/ is generated output and is not committed to the repository. Run npm run build after cloning or pulling changes.

The npm package is built during publish with prepublishOnly; the published package includes dist/ through the files allowlist in package.json.