eggsact evaluates expressions, runs an MCP server, prints diagnostics, updates
the installed binary, and renders MCP client setup instructions.
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.
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 + 3The 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 zeroStart the stdio server with:
eggsact --mcpThe 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 --mcpWith 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.
integrate prints instructions or configuration snippets. It does not edit
client files.
eggsact integrate list
eggsact integrate detect
eggsact integrate codex
eggsact integrate codex --discoveryReplace codex with another supported client name. See
client integration details.
eggsact --diagnostics
eggsact --diagnostics --format jsonDiagnostics 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.