Troubleshooting

Fix common setup and runtime issues.

Run the relevant command below, then include its output if you contact support.

Common Diagnostic Scenarios

Command Not Found:
npm install -g lucentracode lucentracode --version
Tip:Restart your terminal if the command is still unavailable.
Login Problems:
lucentracode status lucentracode logout lucentracode login
Browser Does Not Open:
lucentracode login --no-browser
Tip:Open the displayed URL manually in any web browser.
Model Problems:
lucentracode models
MCP Problems:
lucentracode mcp list lucentracode mcp auth
Verify:Server availability, configuration, dependencies, authentication, and permissions.

Repository-Specific Problems

Check these repository settings:

  • •project configuration and permissions
  • •AGENTS.md
  • •MCP server configuration
  • •required dependencies and scripts

More Help

Include these details for a technical issue:

bash
lucentracode --help
  • •LucentraCode version:
  • •Operating system:
  • •Command:
  • •Expected result:
  • •Actual result:
  • •Error:
  • •Steps to reproduce:
// NOTE:Never send passwords, full API keys, authentication tokens, or production secrets.