Skip to content

freebuff shows "Usage: node mcp_proxy.js <serverId_or_socketPath>" instead of starting the agent #764

@Default-to-AI

Description

@Default-to-AI

Describe the bug
Installed via npm install -g freebuff (v0.0.96). Running freebuff with no arguments shows:
Download complete! Starting Freebuff...
Usage: node mcp_proxy.js <serverId_or_socketPath>
Then exits. Binary enters MCP proxy mode instead of the AI coding agent.
To Reproduce

  1. npm install -g freebuff
  2. freebuff
  3. See error
    Expected
    freebuff with no args should start the interactive agent (logo + login prompt), as documented in the README.
    Root cause
    The npm wrapper (index.js:625) spawns the binary with process.argv.slice(2) — empty when no args passed:
const child = spawn(CONFIG.binaryPath, process.argv.slice(2), ...)
The freebuff.exe binary with zero arguments defaults to MCP proxy mode. It only enters agent UI when at least one argument is given (e.g., --cwd).
Workaround: freebuff --cwd . works correctly.
Environment
- Windows 11, PowerShell/Windows Terminal
- Freebuff v0.0.96
- Fresh install, no modifications
- Binary: ~\.config\manicode\freebuff.exe (142MB, valid PE)
Additional
- freebuff --help and freebuff --version work fine

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions