project_context

project_context finds the project a listing belongs to and reports its type, lockfile state, build artifacts, toolchains and Git state. Reach for it when you move between repositories and want to see each one's state without running several commands.

Turn it on

# ~/.config/lla/config.toml
enabled_plugins = ["project_context"]

Or run lla --enable-plugin project_context, which writes the same setting, so it stays on. lla --disable-plugin project_context removes it.

Output shows in the default, long and table views. In the table view, the long text follows each row.

The plugin looks for Cargo.toml, package.json, pyproject.toml, requirements.txt, setup.py, Pipfile or go.mod, walking up to 12 levels from the path you list. A repository with several ecosystems reports a combined type such as rust+node.

project_health is one of these:

The plugin adds these typed fields: project_type, project_root (path), project_health, project_issues (integer), lockfile_state, build_artifacts, toolchains, repository_state and git_branch. The rest are strings. project_issues counts lock problems plus uncommitted entries. Read them from JSON:

lla --json interface | jq -c '.[] | select(.name == "Cargo.toml") | .plugin | {project_type, project_health, project_issues, git_branch}'

{"project_type":"rust","project_health":"dirty","project_issues":5,"git_branch":"main"}

Or show them as columns:

[formatters.table]
columns = ["name", "field:project_type", "field:project_health"]

Actions

Run an action with lla plugin run project_context <action>.

All of them are interactive, so they need a TTY.

Example

lla plugin run project_context inspect -- .

Root: .
Project types: rust
Health: dirty (5 issues)
Locks: rust:Cargo.lock
Artifacts: none
Toolchains: rustc 1.99.0 (b940084d7 2026-09-28) (Homebrew)
Repository: dirty
Branch: main

A Rust and Node project with no Node lockfile, outside any Git repository, reports:

Root: .
Project types: rust, node
Health: warning (1 issues)
Locks: rust:Cargo.lock; node:missing
Artifacts: target
Toolchains: rustc 1.99.0 (b940084d7 2026-09-28) (Homebrew); node v24.14.1
Repository: not-a-repository

The artifacts it checks for are target, node_modules, .venv, venv, dist, build and __pycache__.

Permissions

process = true, because the plugin runs git status, rustc --version, node --version, python3 --version and go version. It also reads the project tree (metadata:tree, read:tree, read:user-path). Listings reuse a cached result for up to 2 seconds, unless the project's files change.