Troubleshooting

Common Errors

THREADLINE_API_KEY is required

Make sure you've created a .env.local file with your API key, or set it as an environment variable.

THREADLINE_ACCOUNT is required

Add THREADLINE_ACCOUNT to your .env.local file or environment variables.

No valid threadlines found

Run npx threadlines init to create your first threadline, or check that your /threadlines directory contains valid markdown files.

Network error: Could not reach Threadline server

Check that THREADLINE_API_URL is correct, or use --api-url flag to specify the server URL.

Invalid API key

Verify your THREADLINE_API_KEY is correct and matches the server configuration.

Debug Tips

• Use --full flag to see all results, not just attention items
• Check that your threadline patterns match the files you're changing
• Verify context files exist if your threadline references them
• Ensure your git repository is initialized and has changes to review

Pattern Matching Issues

If a threadline isn't running on files you expect:

• Verify the glob pattern matches your file paths
• Remember patterns are relative to repository root
• Test patterns with tools like globtester.com
• Check that file paths in your diff match the pattern

CI/CD Issues

If auto-detection isn't working in CI:

• Verify CI environment variables are set (check platform documentation)
• Check that git repository is properly initialized in CI environment
• Ensure environment variables are set as secrets, not plain text