Installation

Solutioneer runs inside the Codex harness. You install it by cloning the repo, installing the Node dependencies, and copying the eight shipped skills into your Codex skills directory.

Prerequisites

Node.js 20 or newer.
npm on your PATH.
Codex installed and working in your terminal.
Optional: a Firecrawl API key for grounded research.
Optional: a Composio API key for external writeback.

Provider keys are optional. Everything still runs in chat-only, assumption-only mode without them.

1. Clone and install

git clone https://github.com/sushii2/solutioneer.git
cd solutioneer
npm install

The npm install step pulls in the runtime dependencies used by the Firecrawl and Composio wrappers, plus tsx for the skill-install tooling.

2. Install the skills into Codex

Repo-local skills/ folders do not automatically appear in Codex’s skill picker. Install the eight shipped skills into ~/.codex/skills:

npm run install-codex-skills -- --force

If you plan to edit skills locally and want changes to reflect immediately, install them as symlinks instead:

npm run install-codex-skills -- --link --force

Restart Codex after either command so the skill picker reloads.

3. Configure optional provider keys

Copy the example env file and add whichever keys you have:

cp .env.example .env

FIRECRAWL_API_KEY=fc-...
COMPOSIO_API_KEY=cmp-...

Solutioneer loads environment variables in this order:

.env
.env.local
process.env (overrides file values)

See Firecrawl API Key and Composio API Key for how to obtain each key.

4. Start Codex in the repo

codex

From here, Codex has access to the eight skills. Try a natural-language invocation like:

Prepare an account brief for Outtake.ai

Or the explicit syntax:

$account-intel-brief Outtake.ai

Verify the install

The repo ships a doctor command that prints detected providers and missing environment variables:

npm run doctor

You should see your Firecrawl and Composio keys reported as present or missing, and a list of the four installed skills.