CLI Reference

Hegelion ships two CLI entry points focused on MCP integration.

`hegelion-server`

Run the prompt-driven MCP server over stdio.

hegelion-server

Self-test (lists tools and generates a sample prompt):

hegelion-server --self-test

You can also run it as a module:

python -m hegelion.mcp.server

Generate or write MCP configuration for your editor.

Print a JSON snippet:

hegelion-setup-mcp

Write directly to a config file:

hegelion-setup-mcp --write ./mcp_config.json

Write directly to a known host config path:

hegelion-setup-mcp --host claude-desktop
hegelion-setup-mcp --host cursor
hegelion-setup-mcp --host vscode
hegelion-setup-mcp --host windsurf

Example for Claude Desktop (macOS):

hegelion-setup-mcp --write "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Notes:

If Hegelion is not installed in site-packages, the generated config includes PYTHONPATH so the MCP server can import local code.
Restart your MCP host after editing its config.