Hesdor
Archived 7 hours ago
.
Dean
Playing Visual Studio Code
Helper
Open-source, local-first AI software engineering CLI. Point it at a Git repository, give it a task, and Hesdor inspects code, edits files, runs commands and iterates until things work — using your choice of AI provider.
No cloud service. No accounts, billing, telemetry or hosted sandboxes. Your code stays on your machine; prompts go straight to the model provider you configure.
Install
Requires Node.js 22+.
hesdor init # create HESDOR.md + .hesdorignore starters
hesdor doctor # check node/git/ripgrep/provider/credentials
hesdor ask "What does this project do?" # read-only Q&A
hesdor plan "Add rate limiting" # read-only implementation plan
hesdor run "Fix the failing test" # full agent: read + edit + execute
hesdor # interactive TUI
Commands
Providers
Any OpenAI-compatible endpoint works out of the box:
openai · openrouter · groq · deepseek · mistral · together · fireworks · xai · ollama (local) · lmstudio (local) · openai-compatible (custom base URL)
hesdor -p openrouter -m anthropic/claude-sonnet-4.5
hesdor -p ollama -m qwen2.5-coder:7b # fully local
hesdor -p openai-compatible --base-url http://localhost:8080/v1
Defaults persist in the global config (hesdor config: %APPDATA%\hesdor\config.json or ~/.config/hesdor/config.json). API keys are read from environment variables only — never stored in files.
Project context
Hesdor reads lightweight repo metadata (branch, status, manifests), your HESDOR.md instructions and .hesdorignore rules. It never loads the whole repository into model context.
Development
pnpm install
pnpm build # all packages
pnpm test # vitest across packages
pnpm lint # oxlint
pnpm typecheck
MIT licensed.
NOTE : its still 0.1.0 version and am looking for early testers and contributers
https://github.com/ksjxixi-gif/Hesdor
No cloud service. No accounts, billing, telemetry or hosted sandboxes. Your code stays on your machine; prompts go straight to the model provider you configure.
Install
Requires Node.js 22+.
hesdor init # create HESDOR.md + .hesdorignore starters
hesdor doctor # check node/git/ripgrep/provider/credentials
hesdor ask "What does this project do?" # read-only Q&A
hesdor plan "Add rate limiting" # read-only implementation plan
hesdor run "Fix the failing test" # full agent: read + edit + execute
hesdor # interactive TUI
Commands
Providers
Any OpenAI-compatible endpoint works out of the box:
openai · openrouter · groq · deepseek · mistral · together · fireworks · xai · ollama (local) · lmstudio (local) · openai-compatible (custom base URL)
hesdor -p openrouter -m anthropic/claude-sonnet-4.5
hesdor -p ollama -m qwen2.5-coder:7b # fully local
hesdor -p openai-compatible --base-url http://localhost:8080/v1
Defaults persist in the global config (hesdor config: %APPDATA%\hesdor\config.json or ~/.config/hesdor/config.json). API keys are read from environment variables only — never stored in files.
Project context
Hesdor reads lightweight repo metadata (branch, status, manifests), your HESDOR.md instructions and .hesdorignore rules. It never loads the whole repository into model context.
Development
pnpm install
pnpm build # all packages
pnpm test # vitest across packages
pnpm lint # oxlint
pnpm typecheck
MIT licensed.
NOTE : its still 0.1.0 version and am looking for early testers and contributers
https://github.com/ksjxixi-gif/Hesdor