coinhunter-cli

CoinHunter CLI is the executable tooling layer for CoinHunter.

• Code lives in this repository. • User runtime data lives in ~/.coinhunter/ by default. • Hermes skills can call this CLI instead of embedding large script collections. • Runtime locations can be overridden with COINHUNTER_HOME, HERMES_HOME, COINHUNTER_ENV_FILE, and HERMES_BIN.

Install

Editable install:

pip install -e .

Core commands

coinhunter --version
coinhunter doctor
coinhunter paths
coinhunter init
coinhunter check-api
coinhunter smart-executor balances
coinhunter precheck
coinhunter review-context 12
coinhunter market-probe bybit-ticker BTCUSDT

Runtime model

Default layout:

• ~/.coinhunter/ stores config, positions, logs, reviews, and state. • ~/.hermes/.env stores exchange credentials unless COINHUNTER_ENV_FILE overrides it. • hermes is discovered from PATH first, then ~/.local/bin/hermes, unless HERMES_BIN overrides it.

Next refactor direction

This repository now has a dedicated runtime layer and CLI diagnostics. The next major cleanup is to split command adapters from trading services so the internal architecture becomes:

• commands/ • services/ • runtime/ • domain logic

The first split is already in place for:

• smart-executor -> commands.smart_executor + services.smart_executor_service • precheck -> commands.precheck + services.precheck_service