Documentation

Installation, commands, and the core working flow. This page covers the commands you need to install llmenv, set identity, initialize a repo, inspect the merged context, and sync it into supported tools.

Installation

Install globally from npm, then confirm the CLI is available before you begin project setup.

bash

$npm install -g llmenv
$llmenv --help

Identity

Set the developer baseline once so future sessions inherit the same name, role, and communication style.

bash

$llmenv identity --github your-username

Project setup

Initialize inside a repository and immediately scan the codebase so context comes from real files instead of memory.

bash

$llmenv init
$llmenv scan

Profiles and pins

Switch task modes as the work changes and keep recurring constraints sticky with learned or scoped pins.

bash

$llmenv use debug
$llmenv pin "Use describe/it format" --scope "*.test.ts"

Inspect and sync

Use status to inspect the merged layer stack, then sync it into your AI tool rules or preview it with a dry run.

bash

$llmenv status
$llmenv inject "Review this auth flow" --dry
$llmenv sync

CLI Commands Reference

llmenv init

Initialize local project configuration in the current repository.

llmenv scan

Scan package files, TypeScript config, structure, and env examples to enrich project context.

llmenv identity --github <username>

Create or update your global developer identity, optionally using GitHub.

llmenv use [profile]

View or switch the active profile between build, review, debug, learn, and refactor.

llmenv pin <fact>

Create a persistent fact with optional `--learn` and `--scope` flags.

llmenv pins

List saved pins from your global llmenv configuration.

llmenv status

Display the merged identity, profile, project context, and pins.

llmenv sync

Write compact context into supported AI tool rule files.

llmenv inject <prompt>

Wrap a prompt with context and optionally send it to a configured AI provider.

llmenv projects

List registered projects managed through llmenv.

llmenv switch

Choose a registered project and jump back into that workspace.

llmenv history

Review recorded project decision history for previous AI-assisted work.

llmenv config

Configure AI provider credentials for native prompt injection.