Skip to content

Latest commit

 

History

History
113 lines (85 loc) · 3.67 KB

cli.md

File metadata and controls

113 lines (85 loc) · 3.67 KB

CLI Usage

eggsact evaluates expressions, runs an MCP server, prints diagnostics, updates the installed binary, and renders MCP client setup instructions.

Commands

eggsact [options] [expression]
eggsact update
eggsact integrate [client] [--discovery]
Command or option Description
expression Evaluate math. Multiple arguments are joined with spaces.
--mcp Start the MCP server over stdio. The client should launch this process.
--mcp-surface direct or discovery Select the MCP presentation surface. Requires --mcp; defaults to direct.
--diagnostics Print version, tool counts, active settings, and runtime limits.
--format json or text Set diagnostics output format. Requires --diagnostics; defaults to text.
update Download and verify the latest stable release.
integrate List supported clients. integrate detect reports installed clients.
integrate <client> Print setup instructions for zed, codex, claude, cursor, vscode, or opencode.
--discovery Render setup for the discovery surface. Use with integrate <client>.
-h, --help Print command help.
-V, --version Print the installed version.

Running eggsact with no arguments prints help.

Calculator

Quote the expression when your shell would otherwise interpret its symbols:

eggsact "thirty plus five"
eggsact "2 ** 10"
eggsact "30m to ft"

Multiple arguments are joined with spaces, so this also works in many shells:

eggsact 5 + 3

The calculator accepts natural-language math, functions, constants, and unit conversions. ** means power; ^ means bitwise XOR. g means gram. Use gravity or standardgravity for standard gravity. See Math Features for supported operations and units.

log10(x), log2(x), and log1p(x) currently fail through the natural-language path used by the CLI and math_eval. Use log(x, base) instead.

Errors go to stderr and return a non-zero exit code:

$ eggsact "1 / 0"
Error: Division by zero

MCP server

Start the stdio server with:

eggsact --mcp

The default direct surface advertises tools allowed by the active profile and audience. The registry contains 86 tools. In the full profile, the default Model audience sees 77. Other profile and audience combinations show different counts. Run eggsact --diagnostics to see the count for each profile.

Use discovery when the client supports deferred tool discovery:

eggsact --mcp --mcp-surface discovery
# Or set the server-wide default:
EGGSACT_MCP_SURFACE=discovery eggsact --mcp

With the full profile and Model audience, discovery lists five pinned front doors plus the tool_search and tool_invoke facades, seven entries total. Other profile and audience settings may hide pinned tools. Discovery changes presentation, not access policy. See the MCP tool reference for tool behavior and MCP server architecture for protocol details.

Client setup

integrate prints instructions or configuration snippets. It does not edit client files.

eggsact integrate list
eggsact integrate detect
eggsact integrate codex
eggsact integrate codex --discovery

Replace codex with another supported client name. See client integration details.

Diagnostics

eggsact --diagnostics
eggsact --diagnostics --format json

Diagnostics include the version, tool counts by profile, active profile, audience, schema detail, MCP surface, configured limits, and environment variable names. Environment variable values are not printed.