@helmworks/cli
v0.1.0
Published
CLI for HelmWorks: auth, project setup, code indexing
Maintainers
Readme
@helmworks/cli
CLI for HelmWorks — authenticate, index your codebase, and expose a local MCP server for code-graph queries.
Install
npm install -g @helmworks/cliRequires Node >= 20. Native compilation of better-sqlite3 may require build tools (python3, make, g++) if prebuilt binaries are unavailable for your platform.
Quick Start
# Authenticate and link the current project
helmworks init
# Index code symbols (TypeScript, Python, C++, GDScript)
helmworks index
# Start a local MCP server for code-graph queries
helmworks serve
# Proxy MCP traffic to the remote HelmWorks server
helmworks proxyCommands
| Command | Description |
|---------|-------------|
| helmworks init | Authenticate via browser (or --device-code for headless/SSH) and write .helmworks.json |
| helmworks index | Extract symbols from source files and sync to HelmWorks |
| helmworks serve | Start a local stdio MCP server backed by the local symbol database |
| helmworks proxy | Forward MCP requests to the remote HelmWorks API over stdio |
Global Options
--url <url>— HelmWorks instance URL (default:https://helmworks.io)--device-code— Force device-code auth flow (useful over SSH or in containers)
License
MIT
