@incorpus/cli

Thin npm/Bun installer for the native Incorpus CLI.

This package is not the CLI runtime. During installation it downloads the signed/checksummed native binary from GitHub Releases for the current platform and exposes it as incorpus.

The native CLI is Incorpus's only structured agent interface. MCP is not part of Incorpus. Tax Pack is source-data handoff only; tax computations and filing documents belong in the external tax agent's workflow.

The published package includes a generated agent-context/ folder for AI harnesses that inspect installed package files before or without running install scripts. During normal installation, the installer downloads the native binary and asks it to refresh that folder from the binary's embedded CLI resources. The folder is generated during package publishing and install, not checked into source as a separate manual copy, and the same guidance can be regenerated anywhere with incorpus setup-agent.

For AI-agent usage, install the package, then ask your agent to run:

incorpus login
incorpus status
incorpus doctor
incorpus --output json tools

incorpus login opens the user's browser for WorkOS authentication. The agent does not need a source checkout or a manually created API key.

If the AI harness benefits from local markdown context, export the embedded guide:

incorpus setup-agent ./incorpus-agent-context

Give the generated context folder to the customer's AI agent so it can discover supported commands, JSON-output guidance, safety rules, web-only workflows, and official Malaysian accounting/tax/statutory references. Claude Code users can run incorpus setup-claude.

For source-free command discovery, agents can also run:

incorpus --output json tools
incorpus --output json describe invoices create
incorpus --output json describe imports questions generate
incorpus --output json describe accounting-pack preview

The generated context folder includes catalog.json, which contains the same machine-readable command catalog for harnesses that inspect installed package files.

Supported installer platforms match the native release matrix:

• macOS arm64
• macOS x86_64
• Linux amd64
• Linux arm64
• Windows amd64

Environment overrides:

• INCORPUS_CLI_VERSION: release version, defaults to this package version.
• INCORPUS_CLI_RELEASE_TAG: release tag, defaults to v${version}.
• INCORPUS_CLI_REPOSITORY: public GitHub release-artifact repository, defaults to srank-com-my/incorpus-cli.
• INCORPUS_CLI_BINARY_PATH: wrapper-only override for local development.
• INCORPUS_CLI_SKIP_DOWNLOAD=1: skip native binary download during package install. The package still contains the publish-time agent-context/ fallback, but it cannot refresh that context without a native binary.

Troubleshooting:

• Checksum mismatch means the archive is not the release artifact named in checksums.txt; retry against the official release and do not run the binary.
• Unsupported platform errors are expected outside macOS arm64/x64, Linux amd64/arm64, and Windows amd64.
• If incorpus reports that the native binary is missing, reinstall the package so the postinstall step can download the native archive.
• Corporate networks can mirror the GitHub Release files by setting INCORPUS_CLI_REPOSITORY, INCORPUS_CLI_RELEASE_TAG, or using the direct install.sh / install.ps1 scripts with INCORPUS_CLI_DOWNLOAD_BASE_URL.