Installation | Linmas Docs

Choose an Installation Path

Linmas offers multiple distribution paths depending on how you plan to use the security skills and review engine.

Path	Best For	What It Installs
GitHub Source	Contributors, local development, and offline demo validation	Full repository, dev scripts, test fixtures, and offline replay tools
npm Global / npx	Running the Linmas CLI directly in terminal workflows and CI	Published `linmas` package (0.8.0) and CLI executable
Codex Marketplace	Using Linmas skills and MCP tools directly within Codex	`linmas@linmas` plugin (v0.8.0) with 11 skills and 7 MCP tools
Claude Code	Using Linmas skills inside Claude Code	Managed skill files installed via the Linmas CLI

1. Install via npm

Install the global Linmas CLI using npm:

npm install --global linmas@0.8.0
linmas list

Or invoke Linmas on-demand via npx without a global install:

npx --yes linmas@0.8.0 list
npx --yes linmas@0.8.0 review --skill linmas-secure-code-reviewer --input patch.diff

2. Install from GitHub Source

git clone https://github.com/TanKimGwan/linmas.git
cd linmas
npm ci
npm link
linmas list

To run directly without linking:

node bin/linmas.mjs list
node bin/linmas.mjs review --skill linmas-secure-code-reviewer --input patch.diff

3. Install into Codex

Add Linmas to Codex from its canonical Git repository:

codex plugin marketplace add TanKimGwan/linmas --ref v0.8.0
codex plugin add linmas@linmas
codex plugin marketplace list --json
codex plugin list --json

Post-Install Verification

After installing or upgrading the Codex plugin, verify that codex plugin list --json reports version 0.8.0. Restart the Codex desktop or app-server, and start a fresh task to load the updated skills and MCP tools.

4. Single Skill Installation

If you only require a specific skill (e.g. linmas-secure-code-reviewer), you can inspect and copy its canonical prompt fromskills/linmas-secure-code-reviewer/SKILL.md ↗ into your agent's instructions.