agent-profile

library0.3.5jsnpmunverified

Local-first CLI tool for compiling a single ai-profile.yaml into deterministic configuration files for AI coding agents (Codex, Claude, Tabnine). Version 0.3.5 (preview) requires Node.js >=24 and npm >=11. Differentiator: treats agent-specific configs as generated artifacts from a single source of truth, preventing drift; no telemetry by default; all processing local.

devops ai-ml

npm install agent-profile

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · AGENT-PROFILE

agent-profile

devopsjavascriptv0.3.5

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

init

✓ npx agent-profile init

✗ npm install -g agent-profile && agent-profile init

npx is recommended to get latest; global install may pin older version.

compile

✓ npx agent-profile compile --dry-run

✗ npx agent-profile compile

Always use --dry-run first to preview changes; --write applies them.

doctor

✓ npx agent-profile doctor

No common mistakes; simple invocation.

✓ npx agent-profile ui

Binds to loopback only; optional --root and --port flags.

Initialize a profile, compile for all targets (dry-run then write), run doctor check, and start local UI.

cd /tmp/my-project npx agent-profile init --dry-run npx agent-profile init --write npx agent-profile compile --dry-run npx agent-profile compile --write npx agent-profile doctor npx agent-profile ui

Debug

Known issues

deprecatedThe 'compile' command output format may change before 1.0.

fix

Pin to a specific version if you rely on generated file structure.

affects: >=0.1.0 <1.0.0

breakingNode.js version must be >=24.0.0.

fix

Upgrade Node.js via nvm or NodeSource.

affects: >=0.3.0

breakingnpm version must be >=11.0.0.

fix

Upgrade npm with 'npm install -g npm@latest'.

affects: >=0.3.0

gotchainit --write will not overwrite existing ai-profile.yaml; use --force if needed.

fix

Add --force flag: npx agent-profile init --write --force

affects: >=0.1.0

gotchaThe UI command requires a browser to view; it does not open one automatically.

fix

Manually navigate to http://localhost:5174 (or custom --port).

affects: >=0.1.0

Errors

Common errors & fixes

Error: '--write' must be explicitly provided to write files

Safety check prevents accidental writes.

fix

Add --write flag: npx agent-profile compile --write

Error: Requires Node.js >= 24.0.0 (current: 20.11.0)

Outdated Node.js version.

fix

Install Node.js 24+ via nvm: nvm install 24

Error: Requires npm >= 11.0.0 (current: 10.9.2)

Outdated npm version.

fix

Upgrade npm: npm install -g npm@latest

Error: Could not detect supported stack languages in project root

Project lacks recognized metadata files (package.json, tsconfig.json, etc.).

fix

Ensure package.json exists, or create ai-profile.yaml manually.

Upgrade

Version history

0.3.5latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

39 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/jsuvic/agent-profile ↗

packageagent-profile ↗

homepagehttps://github.com/jsuvic/agent-profile#readme ↗