Installation

Prerequisites

Bun runtime (latest version recommended)
Node.js v18 or later
Git for cloning the repository
At least one AI provider API key

Install via npm

You can install LLPM globally as a CLI using npm:

npm install -g @britt/llpm
llpm

Install from Source

Clone the repository

git clone https://github.com/britt/llpm.git
cd llpm

Install dependencies
```
bun install
```
If Bun blocks postinstall scripts for untrusted packages, add @britt/llpm to trustedDependencies in your global ~/.bunfig.toml.
Example:
```
[install]
trustedDependencies = ["@britt/llpm"]
```
Configure environment
Create a .env file with your API keys (see Environment Variables below).
Make it executable (optional)
```
chmod +x index.ts
```

Notes

Requires Node.js v18 or later (consistent with the prerequisites above).
Environment variables are still required; configure them as described in Environment Variables.
In environments that restrict postinstall scripts, ensure that scripts from @britt/llpm are allowed so that all tooling is set up correctly.

Install Globally (optional)

bun link
llpm

Verify Installation

bun start
# or if linked globally
llpm

You should see the LLPM welcome screen and prompt.

Environment Variables

Create a .env file in the project root with your AI provider API keys:

# At least one AI provider is required
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...

# Optional: GitHub integration
GITHUB_TOKEN=ghp_...

# Optional: Web search
ARCADE_API_KEY=your-arcade-api-key-here

Bun automatically loads environment variables from .env files.

Quickstart