Skip to content

fix(dx): Improve error messages when Ollama is not running #4

Description

@sunilp

Summary

When Ollama is not running or unreachable, the current error message could be more helpful.

Current Behavior

The error message mentions that Ollama is unreachable but could provide more actionable guidance.

Expected Behavior

The error should:

  1. Clearly state that Ollama is not reachable at the configured URL
  2. Suggest running ollama serve to start it
  3. If it's a connection refused error, suggest checking if Ollama is installed
  4. If using a non-default URL, mention the configured baseUrl
  5. Suggest running jam doctor for full diagnostics

Files to Check

  • src/providers/ollama.ts — error handling in validateCredentials(), streamCompletion(), and listModels()
  • src/utils/errors.tsJamError class

Acceptance Criteria

  • Clear, actionable error messages for connection refused / timeout / DNS failure
  • jam doctor suggestion in error output
  • No regression in existing tests

Metadata

Metadata

Assignees

No one assigned

    Labels

    dxDeveloper experience improvementsgood first issueGood for newcomers

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions