josharsh / josharsh/md-pdf-md

Add more helpful error messages for common CLI mistakes

Open
#2 0 comments 0 reactions 0 assignees View on GitHub
cli enhancement good first issue help wanted
Dominant language
TypeScript
Stars
7
Forks
2
PR merge metrics
No merged PRs in 30d

Description

Make error messages more user-friendly when users make common mistakes.

**Tasks:**
- Add specific error when file doesn't exist
- Add hint when Ollama is not running (for PDF→MD)
- Add suggestion when wrong file type is provided
- Improve error formatting with colors (using chalk)

**Files to modify:**
- `src/cli.ts`
- `src/converters/pdf-to-markdown.ts`

**Good First Issue:** Simple TypeScript changes with clear requirements!

Contributor guide

No contributing guide indexed for this repository

Research direction

Start in src/cli.ts and src/converters/pdf-to-markdown.ts; trace the existing error paths for missing files, a stopped Ollama service, wrong file types, and formatting. Confirm each mistake produces the requested hint or suggestion and that error output uses chalk for colors.

Written by the indexing model from the issue text.

Assessment

Tech stack
node.js, ollama, typescript
Domain
ai, cli
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.