Troubleshooting

Common situations and how to unstick them.

"lc: command not found" or lc prints a directory listingCopy Anchor Link

Two possibilities:

1. The tool isn't on PATH. With uv tool install, that's ~/.local/bin; uv tool update-shell fixes the profile.
2. Your shell has a personal alias lc='ls --color' shadowing the real command. Run type lc to see; unalias lc to remove.

git doesn't know who you areCopy Anchor Link

Every output is committed, so a machine that has never committed needs an identity before the first run. lc materialize checks up front, before any recipe spends time:

git config --global user.name "Ada Lovelace"
git config --global user.email "ada@example.org"

Filing a bugCopy Anchor Link

Open an issue at github.com/LightconeResearch/lightcone-cli/issues. Include the output of lc --version, the command you ran, and the full message: the refusals are designed to be pasted.