@lumidesk/toolpilot

Privacy-first developer & text utilities, right in your terminal — the CLI companion to ToolPilot.

Everything runs locally on your machine. Nothing is uploaded, no network calls, no telemetry — the same promise as the website.

Install

npm install -g @lumidesk/toolpilot

Then run toolpilot --help.

Requires Node.js ≥ 18.3.

Commands

| Command | What it does | | --- | --- | | toolpilot json [--minify] [--indent N] [file\|-] | Format & validate JSON | | toolpilot base64 <encode\|decode> [text\|-] | Encode / decode Base64 | | toolpilot url <encode\|decode> [--full] [text\|-] | Encode / decode URL components | | toolpilot hash <algo> [--uppercase] [text\|-] | md5, sha1, sha256, sha384, sha512 | | toolpilot uuid [--count N] | Random UUID v4 identifiers | | toolpilot password [--length N] [--count N] [--no-symbols] … | Secure random passwords | | toolpilot wordcount [--json] [file\|-] | Words, characters, sentences, reading time | | toolpilot case <type> [text\|-] | upper, lower, title, sentence, camel, pascal, snake, kebab | | toolpilot lorem [--type paragraphs\|sentences\|words] [--count N] | Lorem Ipsum placeholder text | | toolpilot color <#RRGGBB\|rgb(r,g,b)> | Convert between HEX, RGB, HSL, CMYK | | toolpilot regex <pattern> [--flags gi] [text\|-] | Test a regular expression | | toolpilot qr <text> [--output file.png\|.svg] | QR code (terminal, PNG or SVG) | | toolpilot pdf merge <a.pdf> <b.pdf> … --output out.pdf | Merge PDFs | | toolpilot pdf split <in.pdf> [--pages 1-3,5] --output out.pdf | Extract pages | | toolpilot serve [--port 4321] | Open the local web version in your browser | | toolpilot mcp | Run as an MCP server (stdio) for Claude, Cursor & other AI clients | | toolpilot list | List all commands |

Most text commands read from a positional argument or from stdin, so they compose in pipelines:

echo '{"b":1,"a":2}' | toolpilot json
cat notes.txt | toolpilot wordcount
toolpilot hash sha256 "hello world"
toolpilot password --length 24 --exclude-similar
toolpilot qr "https://tool.talyra42.top"
toolpilot color "#3b82f6"

Local web version

toolpilot serve

Boots a tiny server on localhost and opens a browser UI with the text, developer and generator tools. It calls the same local logic the CLI uses — no data ever leaves your machine.

Use from AI assistants (MCP)

ToolPilot can run as a Model Context Protocol server, exposing the text/developer/generator tools so AI clients (Claude Desktop, Claude Code, Cursor, …) can call them natively — locally, with no network access.

toolpilot mcp   # speaks MCP over stdio

Register it with your client. For example, in Claude Desktop's claude_desktop_config.json:

{
  "mcpServers": {
    "toolpilot": {
      "command": "npx",
      "args": ["-y", "@lumidesk/toolpilot", "mcp"]
    }
  }
}

Or with Claude Code:

claude mcp add toolpilot -- npx -y @lumidesk/toolpilot mcp

Exposed MCP tools: json_format, base64, url_encode, hash, uuid, password, word_count, case_convert, lorem, color_convert, regex_test, qr_code.

License

AGPL-3.0-only