Troubleshooting

# 1. Re-source your shell config
source ~/.zshrc   # or source ~/.bashrc

# 2. Verify the binary is on your PATH
which deepline

Set up Deepline in this environment by following https://code.deepline.com/SKILL.md. Read and follow the skill exactly.

npm install -g deepline@latest && npm exec --yes --package=deepline@latest -- deepline setup --json

echo $PATH | tr ':' '\n' | grep -E "(local/bin|deepline)"

# Test npm connectivity
npm view deepline version

export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port
npm install -g deepline@latest
deepline setup --json

# Register and authenticate (opens your browser)
deepline auth register

deepline auth status

# Re-run registration - it will generate a fresh link
deepline auth register

# Check your current auth state
deepline auth status

# If unauthorized, re-register to get a fresh API key
deepline auth register

deepline auth status

# Single provider - limited coverage
deepline enrich --input contacts.csv --with '{"alias":"email","tool":"apollo_people_match","payload":{"first_name":"{{first_name}}","last_name":"{{last_name}}","organization_name":"{{company}}"}}'

# Waterfall - cascades through providers, stopping when data is found
# Add multiple --with steps that run cheapest-first
deepline enrich --input contacts.csv \
  --with '{"alias":"email_serper","tool":"serper_google_search","payload":{"q":"{{first_name}} {{last_name}} {{company}} site:linkedin.com"}}' \
  --with '{"alias":"email_apollo","tool":"apollo_people_match","payload":{"first_name":"{{first_name}}","last_name":"{{last_name}}","organization_name":"{{company}}"}}'

deepline enrich --input enriched_contacts.csv \
  --with '{"alias":"validate","tool":"leadmagic_email_validation","payload":{"email":"{{email}}"}}'

# Test with just the first row before running the full list
deepline enrich --input contacts.csv --rows 0:1 \
  --with '{"alias":"email","tool":"apollo_people_match","payload":{"first_name":"{{first_name}}","last_name":"{{last_name}}","organization_name":"{{company}}"}}'

Invalid JSON payload in --with spec: ... (Expecting property name enclosed in double quotes)
Tip: --with now accepts only JSON object specs, e.g.
--with '{"alias":"email_step","tool":"apollo_people_match","payload":{...},"extract_js":"extract(\"email\")"}'

# Correct
--with '{"alias":"step1","tool":"apollo_people_match","payload":{"name":"{{first_name}}"}}'

# Wrong - double quotes conflict with bash
--with "{\"alias\":\"step1\",\"tool\":\"apollo_people_match\"}"

# Save your spec to a file
echo '{"alias":"step1","tool":"apollo_people_match","payload":{"name":"test"}}' > spec.json

# Reference the file with @
deepline enrich --input contacts.csv --with @spec.json

Invalid --with spec: unknown key(s): <key>. Allowed keys: alias, tool, payload, extract_js, run_if_js.

# Both alias and tool are required
--with '{"alias":"find_email","tool":"apollo_people_match","payload":{...}}'

deepline tools list

# BYOK keys are managed in the dashboard at https://code.deepline.com/dashboard/keys

# Update the CLI and replace stale Deepline skills
deepline update

# Verify the skill file exists
ls ~/.claude/skills/

deepline update

cat ~/.claude/skills/deepline/SKILL.md | head -5

# Query your results
deepline db query --sql "SELECT * FROM enrichment_results LIMIT 10"

deepline auth status --reveal

# Wrong
deepline db query "SELECT * FROM contacts"

# Correct
deepline db query --sql "SELECT * FROM contacts"

deepline auth register

# BYOK keys are managed in the dashboard at https://code.deepline.com/dashboard/keys

# Re-authenticate
deepline auth register

# Verify
deepline auth status

curl -s https://api.deepline.com/health

deepline csv render stop
deepline csv render start

DEEPLINE_DEBUG_ENRICH=1 deepline csv render start