tool-installation.md

Tool Installation Notes

Tools Managed by mise

The following tools are automatically installed and managed by mise.toml:

✅ Installed via mise:

• node (24.9.0)
• pnpm (10.18.1)
• prettier (3.6.2)
• dotenv-linter (3.3.0)
• trufflehog (3.90.8)
• snyk (1.1260.0)
• semgrep (1.139.0)
• uv (0.7.16)
• typos (1.38.1)
• shellcheck (0.11.0)
• actionlint (1.7.7)
• lefthook (1.13.6)

Tools Not Available in mise Registry

Some tools referenced in the project are not available via mise and need alternative installation:

oxlint

Status: In devDependencies (package.json)
Current installation: npm package
Install via:

# Already in package.json devDependencies
pnpm install

# Global install (optional)
npm install -g oxlint

Usage: pnpm exec oxlint or oxlint (if global)

Verification

Check all tools are installed:

# mise-managed tools
mise ls --current

# oxlint (via pnpm)
pnpm exec oxlint --version

# Verify all tasks work
mise task ls

Recommendations

Current Setup

• oxlint: Keep in devDependencies
• Others: Managed by mise ✅

Post-Installation Setup

After tools are installed:

1. Install git hooks:

   # Using husky (current)
   pnpm run prepare
   
   # Or using lefthook (alternative)
   mise run hooks-install

2. Run initial audit:

   mise run audit

3. Test security scans:

   mise run security

4. Verify spellcheck:

   mise run spellcheck

Troubleshooting

Tool not found

# Reinstall mise tools
mise install

# Check installation
mise doctor

oxlint not found

# Install dependencies
pnpm install

# Verify
pnpm exec oxlint --version

CI/CD Considerations

For CI/CD pipelines, you'll need to install:

1. mise (one-time):

   curl https://mise.run | sh

2. mise tools:

   mise install

3. npm dependencies:

   pnpm install

Example GitHub Actions:

- name: Setup mise
  uses: jdx/mise-action@v2

- name: Install tools
  run: mise install

- name: Install dependencies
  run: pnpm install

- name: Run audit
  run: mise run audit