# 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:

```bash
pip install -e .
```

## Core commands

```bash
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