boomkin 0.8.1 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,21 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.9.1 · 2026-10-08
4
+
5
+ - Refresh the GitHub and npm introduction with a browser demo, clear installation steps and a public-data first task.
6
+ - Add human and agent documentation indexes, accessible README artwork and current discovery metadata.
7
+ - Update the reviewed catalog to independently published documentation patches for all 17 skill packs.
8
+ - Route Hyperliquid account inspection to its account-monitoring skill.
9
+ - Keep npm commands and the website setup guide aligned; fix the strategy lab heading after an invalid run.
10
+
11
+ ## 0.9.0 · 2026-10-08
12
+
13
+ - Add local discovery of 60 providers with primary-source provenance, capability, access, cost and transaction authority metadata.
14
+ - Expand to 27 workflows and 17 reviewed packs containing 48 active skills, including unsigned plans, simulations, Aave V4, payment streams and prediction-market evidence.
15
+ - Add optional Blockscout discovery with 15 explicitly reviewed reads; keep provider selection and connections scoped to the selected profile.
16
+ - Bound public MCP discovery by time, response size and pagination; preserve redacted failures and reject redirected endpoints.
17
+ - Publish source-backed provider documentation and catalogs on the website, and validate tool filters against the pinned native Hermes contract.
18
+
3
19
  ## 0.8.1 · 2026-10-02
4
20
 
5
21
  - Correct the published README catalog count and list the strategy pack and three new workflows. Keep npm and website installation commands aligned with this patch release.
package/README.md CHANGED
@@ -2,191 +2,140 @@
2
2
 
3
3
  **Your open-source DeFi desk.**
4
4
 
5
- Inspect an Aave position, track a Lido withdrawal, size a Uniswap range, check Aerodrome gauge custody or screen DefiLlama yields. Boomkin installs protocol-specific procedures and local helpers into the native [Hermes Agent](https://github.com/NousResearch/hermes-agent), with reviewed source pins and file-integrity checks.
5
+ Research markets, inspect positions and test a thesis with a native [Hermes agent](https://github.com/NousResearch/hermes-agent). Keep the sources, assumptions and run history in your own profile.
6
6
 
7
- Each workflow names the reads to make, the accounting that matters and the evidence needed to finish. Official provider tools do the protocol work; Hermes handles the agent loop.
7
+ [![Boomkin: research, inspect and test your DeFi thesis](https://raw.githubusercontent.com/galleonlabs/boomkin/main/docs/assets/boomkin-hero.svg)](https://galleonlabs.github.io/boomkin/lab/)
8
8
 
9
- [Website](https://galleonlabs.github.io/boomkin/) · [Strategy lab](https://galleonlabs.github.io/boomkin/lab/) · [Documentation](https://galleonlabs.github.io/boomkin/docs/) · [Contribute](CONTRIBUTING.md)
9
+ **[Try the strategy lab →](https://galleonlabs.github.io/boomkin/lab/)** · [Explore workflows](https://galleonlabs.github.io/boomkin/#workflows) · [Read the docs](https://galleonlabs.github.io/boomkin/docs/)
10
+
11
+ The browser demo needs no installation. Compare daily spot rules, change fees and slippage, and inspect simulated trades using a dated Bitcoin capture, synthetic prices or your own dataset. Uploaded data stays in your browser.
12
+
13
+ **27 workflows · 60 providers in discovery · 17 independent packs · 48 reviewed skills**
10
14
 
11
15
  [![CI](https://github.com/galleonlabs/boomkin/actions/workflows/ci.yml/badge.svg)](https://github.com/galleonlabs/boomkin/actions/workflows/ci.yml)
16
+ [![npm](https://img.shields.io/npm/v/boomkin)](https://www.npmjs.com/package/boomkin)
12
17
  [![MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
13
18
 
14
19
  ## Get started
15
20
 
16
- Use macOS or Linux, [Bun](https://bun.sh), Git and a terminal. For Windows, use WSL2 or install Hermes with its official Windows flow first. Optional Coinbase tooling requires Node.js 22+; Agentic Wallet's current guide requires Node.js 24+.
21
+ Use macOS or Linux with [Bun](https://bun.sh) 1.3.12+ and Git. Windows users can use WSL2.
17
22
 
18
23
  ```bash
19
- bun install -g boomkin@0.8.1
24
+ bun install -g boomkin@0.9.1
20
25
  boomkin onboard
21
26
  boomkin doctor --live
22
27
  boomkin start
23
28
  ```
24
29
 
25
- Bun and Git are prerequisites. Keep Bun's global bin directory on your path. For a source checkout:
26
-
27
- ```bash
28
- git clone https://github.com/galleonlabs/boomkin.git
29
- cd boomkin
30
- bun install --frozen-lockfile
31
- bun run boomkin onboard
32
- bun run boomkin doctor --live
33
- bun run boomkin start
34
- ```
30
+ Onboarding prepares `~/.boomkin/hermes`, installs the reviewed packs, configures public CoinGecko data and opens native Hermes model setup. Choose your model provider and sign in there. `start` opens chat in that profile.
35
31
 
36
- `onboard` prepares `~/.boomkin/hermes`, installs the reviewed official Hermes runtime if none is available, installs all packs in the reviewed catalog on a fresh profile, creates Boomkin's SOUL and instructions, configures public CoinGecko MCP, and opens native Hermes model setup. Choose your provider and sign in there. `start` launches the native Hermes chat in that same profile.
32
+ CoinGecko is the sole default connection. Model access uses your account or local configuration; optional providers can require credentials, subscriptions or paid requests. Setup creates no wallet, makes no model call and starts no background service.
37
33
 
38
- Hermes remains the runtime: its tools, sessions, memory, model adapters, MCP support and scheduling are not forked. A new runtime installation uses reviewed Hermes v0.21.5 source (upstream tag `v2026.9.24`); the native installer also manages the user-level `hermes` command and dependencies. Browser/computer-use dependencies are skipped initially and can be added through native Hermes setup. An existing working Hermes installation at 0.21.0 or newer is reused, not downgraded.
39
-
40
- Model authentication requires your account or local model configuration. Optional providers can require subscriptions, OAuth or scoped credentials. Onboarding makes no model call, pays for no data, creates or funds no wallet, and starts no background service.
41
-
42
- Useful options:
43
-
44
- ```bash
45
- bun run boomkin onboard --directory "$HOME/defi-agent" --dry-run
46
- bun run boomkin onboard --directory "$HOME/defi-agent" --skip-model-setup
47
- bun run boomkin onboard --directory "$HOME/defi-agent" --no-install
48
- bun run boomkin model --directory "$HOME/defi-agent"
49
- ```
34
+ [Profiles, install options and source setup](docs/GETTING-STARTED.md) · [Model connections](docs/CONNECTIONS.md)
50
35
 
51
- Use the same `--directory` for subsequent commands. `--skip-model-setup` is for preparing a profile before interactive login; it does not mark the model authenticated. Existing SOUL, instructions and unrelated settings are preserved. A conflicting named MCP configuration is reported for review instead of overwritten.
52
-
53
- ## Keep the question and the evidence
36
+ ## First useful task
54
37
 
55
- Save a research question as a project, preview its brief and run it through native Hermes. Each run keeps its own report, raw sources, observation hashes and reviewable unsigned plan. A model response stays in review until its artifact checks pass. [Project commands and output contract](docs/PROJECTS.md).
38
+ Paste this into your new Hermes chat:
56
39
 
57
- ```bash
58
- boomkin project create --name stablecoin-yields \
59
- --workflow yield-screen --input-file ./inputs.json
60
- boomkin project run --name stablecoin-yields --dry-run
61
- boomkin project run --name stablecoin-yields
62
- boomkin project check --name stablecoin-yields
63
- ```
40
+ > Use galleon-coingecko-token-research. Resolve CoinGecko ID ethereum and capture a public ETH/USD market observation. Show the asset identity, source URL, observation time and freshness limits. Mark missing data clearly and keep this task read-only.
64
41
 
65
- Public market snapshots compare fresh CoinGecko and DefiLlama observations while keeping unavailable, stale and disagreeing sources visible. The strategy pack runs local daily spot simulations with next-observation decisions, fixed fees and adverse slippage, flow-neutral returns, drawdown and a same-flow buy-and-hold benchmark. [Try the same engine in the browser](https://galleonlabs.github.io/boomkin/lab/) with a dated Bitcoin capture, synthetic fixtures or your own dataset.
42
+ The result should separate supported observations from unknowns. `doctor --live` establishes public tool discovery; this first task checks whether your configured model can retrieve and explain market evidence.
66
43
 
67
44
  ## Pick a job
68
45
 
69
46
  ```bash
70
- bun run boomkin workflows
71
- bun run boomkin workflows --protocol Uniswap
72
- bun run boomkin workflows --workflow aave-health --json
73
- bun run boomkin onboard --workflow aave-health
47
+ boomkin workflows
48
+ boomkin workflows --protocol Aave
49
+ boomkin workflows --workflow transaction-simulation --json
50
+ boomkin onboard --workflow aave-health
74
51
  ```
75
52
 
76
- `workflows` works before setup and makes no network calls. It shows the required inputs, deliverable and provider access. `--workflow` installs that task's independent pack. On an existing profile it selects that pack for future updates, just like `--pack`; already copied files and custom instructions are preserved. Use a separate `--directory` for a dedicated task profile.
53
+ Workflow discovery runs locally. Each job names its inputs, expected result and provider requirements. Selecting a workflow installs its pack and saves that selection for updates. Already copied skills remain; choose a separate `--directory` for a dedicated profile.
77
54
 
78
- | Task | What you get |
55
+ | You want to… | Start with |
79
56
  | --- | --- |
80
- | `market-snapshot` | Source timestamps, raw-response hashes and public price comparison |
81
- | `strategy-backtest` | Reproducible daily spot tests, costs and a same-flow benchmark |
82
- | `thesis-review` | Saved thesis, invalidation conditions and fresh evidence for review |
83
- | `aave-health` | V3 position reads, stressed health factor and reserve constraints |
84
- | `morpho-market` / `compound-borrow` | Protocol-specific collateral, debt and liquidity analysis |
85
- | `uniswap-position` / `aerodrome-position` | Position accounting, range checks and gauge/exit requirements |
86
- | `uniswap-quote` / `bridge-status` | Route review, permissions and settlement evidence |
87
- | `lido-exit` | Withdrawal NFT ownership, finalization and claimability |
88
- | `pendle-maturity` / `vault-exit` | Maturity accounting and what can actually be redeemed |
89
- | `token-research` / `yield-screen` | Contract-based identity and reproducible yield screening |
90
- | `coinbase-readiness` | CDP/AgentKit capabilities and policy gaps |
91
- | `hyperliquid-risk` | Venue/account-mode, margin and funding analysis |
57
+ | Capture market evidence or test a rule | `market-snapshot`, `strategy-backtest` |
58
+ | Inspect lending or an exit | `aave-health`, `aave-v4-health`, `morpho-market`, `lido-exit` |
59
+ | Review liquidity and routes | `uniswap-position`, `aerodrome-position`, `across-route` |
60
+ | Screen income or streaming obligations | `yield-screen`, `sablier-stream`, `superfluid-stream` |
61
+ | Review an exact unsigned payload | `unsigned-plan`, `transaction-simulation` |
62
+ | Research prediction markets | `prediction-research`, `prediction-resolution` |
92
63
 
93
- ## Skill packs
94
-
95
- The reviewed catalog contains **15 independent packs and 41 skills**. Install all of them or choose the workflows you need; the agent loads relevant instructions on demand.
64
+ [All 27 workflows, inputs and outputs](docs/WORKFLOWS.md)
96
65
 
97
- | Pack | What it covers |
98
- | --- | --- |
99
- | [Infrastructure](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/infra) | RPC, Alchemy, Coinbase, wallet policies and readiness |
100
- | [Data](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/data) | CoinGecko, DefiLlama and AIXBT research, identity, freshness and source-hashed market captures |
101
- | [Strategy](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/strategy) | Daily spot simulations, cash flows, costs, drawdown and reproducible benchmarks |
102
- | [Liquidity provision](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/lp) | Uniswap, Aerodrome, Revert and VFAT position workflows |
103
- | [Hyperliquid](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/hyperliquid) | Venue-specific analysis, planning, execution, monitoring and review |
104
- | [Lending](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/lending) | Collateral, borrowing, interest, repayment and liquidation risk |
105
- | [Staking](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/staking) | Staking, restaking, receipts and withdrawal queues |
106
- | [Yield](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/yield) | Vault diligence, share accounting and yield sources |
107
- | [Tokenized assets](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/tokenized-assets) | Asset claims, eligibility, restrictions and redemption |
108
- | [Routing](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/routing) | Swap and bridge quotes, route limits and settlement |
109
- | [Derivatives](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/derivatives) | Exposure, margin, funding and venue-specific constraints |
110
- | [Portfolio](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/portfolio) | Assets, debt, cash flows, performance and rebalance plans |
111
- | [Security](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/security) | Token diligence, evidence comparisons, transaction effects and permissions |
112
- | [Payments](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/payments) | Agent payments, x402 challenges and settlement evidence |
113
- | [Governance](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/governance) | Proposals, voting, delegation and execution stages |
114
-
115
- Start with the protocol workflow matching your task. Use infrastructure and cross-protocol skills when the task needs them. The broader primitive skills use the `galleon-defi-` prefix to avoid upstream name collisions. Read [workflow examples](docs/WORKFLOWS.md) for useful combinations.
116
-
117
- Each pack is independently versioned and published from [crypto-defi-skills](https://github.com/galleonlabs/crypto-defi-skills). Boomkin's [catalog](catalog/skills.json) records the npm identity, version, immutable source commit, package directory and expected skills. Downloads, installed metadata and every copied supporting file are checked before a successful sync is recorded. Local file digests let `check` and `doctor` detect missing references and changed scripts afterward.
118
-
119
- Fresh onboarding includes every pack in the checked-out catalog. Select fewer with repeated `--pack` options:
66
+ ## Keep the question and the evidence
120
67
 
121
- ```bash
122
- bun run boomkin onboard --pack defi-infra-skills --pack defi-data-skills
68
+ Save this public research example as `inputs.json`:
69
+
70
+ ```json
71
+ {
72
+ "chain": "Ethereum",
73
+ "asset": "USDC",
74
+ "minimumTvlUsd": "10000000",
75
+ "yieldPreference": "Separate base yield from incentive emissions",
76
+ "limit": 5,
77
+ "question": "What evidence is missing before a deposit decision?"
78
+ }
123
79
  ```
124
80
 
125
- Updates preserve your selection. Future packs are opt-in. To expand an existing installation deliberately:
126
-
127
81
  ```bash
128
- bun run boomkin onboard --directory "$HOME/your-existing-hermes-profile" --all-packs
82
+ boomkin project create --name stablecoin-yields \
83
+ --workflow yield-screen --input-file ./inputs.json
84
+ boomkin project run --name stablecoin-yields --dry-run
85
+ boomkin onboard --workflow yield-screen --skip-model-setup
86
+ boomkin project run --name stablecoin-yields
87
+ boomkin project check --name stablecoin-yields
129
88
  ```
130
89
 
131
- Other harnesses can still install the portable skills through [advanced compatibility setup](docs/HARNESSES.md). Boomkin's end-to-end product flow is Hermes-first.
90
+ Creation and preview make no model or data calls. Onboarding prepares the selected workflow and preserves your configured model. A live run uses that model and your tools, then saves a separate report, raw sources, hashes and unsigned plan. Checks establish the saved evidence contract; they do not certify economic safety or authorize execution. [Project guide](docs/PROJECTS.md)
132
91
 
133
- ## Connect your tools
92
+ ## Discover the right provider
134
93
 
135
94
  ```bash
136
- bun run boomkin providers
137
- bun run boomkin connect --provider aixbt
138
- bun run boomkin connect --provider alchemy
139
- bun run boomkin connect --provider defillama
140
- bun run boomkin connect --provider coinbase
141
- bun run boomkin connect --provider tenderly
95
+ boomkin providers --search simulation --json
96
+ boomkin providers --capability Data --access keyless
97
+ boomkin providers --provider blockscout
142
98
  ```
143
99
 
144
- | Connection | Setup and scope |
145
- | --- | --- |
146
- | CoinGecko | Public, keyless MCP configured during onboarding. Its reviewed tools are `execute` and `search_docs`; hosted execution is restricted to the provider's data SDK. |
147
- | Alchemy | Native Hermes OAuth and explicit tool selection. Select the intended Alchemy app; data/RPC access and wallet/admin actions have different scopes. |
148
- | AIXBT | Optional crypto intelligence through native Hermes MCP; the key stays in `AIXBT_API_KEY`. Discovery is public; protected research reads require account access. |
149
- | DeFiLlama | Native Hermes OAuth with an API subscription. Queries consume credits; connecting another client can disconnect the previous client. |
150
- | Tenderly | Optional paid-plan OAuth with explicit tool selection. Simulations and inspection require the intended project; results persist there. |
151
- | Coinbase account | Official local MCP through a pinned CLI, with six read tools and a profile-specific configuration/keychain environment. Account credentials remain a separate step. |
152
- | Agentic Wallet | Separate official `awal` CLI flow for managed wallet and x402 use. Login, wallet creation, funding and spend limits require your choices; see the connection guide. |
100
+ The directory covers 58 studied [skills.eth.sh](https://skills.eth.sh/) entries and two existing connections. Dated sources distinguish authorship, access, cost and authority. Discovery does not install or connect all 60 providers. Keyless access can still cost money; wallet and x402 capabilities need separate choices. [Provider guide](docs/PROVIDERS.md)
153
101
 
154
- For Coinbase, supply a scoped key file to the native CLI through Boomkin:
102
+ ## Connect your tools
155
103
 
156
104
  ```bash
157
- bun run boomkin connect --provider coinbase --key-file /absolute/path/to/scoped-key.json
105
+ boomkin connect --provider blockscout
106
+ boomkin doctor --live
158
107
  ```
159
108
 
160
- The command uses the OS keychain and does not opt into plaintext secret storage. It configures credentials; it does not check balances, trade or approve payments. Coinbase's remote account MCP currently restricts custom harnesses, so Boomkin uses its supported local server. Coinbase for Agents and Agentic Wallet have different custody and payment capabilities.
109
+ Blockscout adds optional keyless explorer reads. Other supported connections include AIXBT, Alchemy, DeFiLlama, Tenderly and Coinbase account data, each with its own setup and access boundary. Restart Hermes after changing MCP settings.
161
110
 
162
- Read [the connection guide](docs/CONNECTIONS.md) for exact prerequisites, diagnostics and limits. Restart Hermes after changing MCP settings. MCP tool selection controls that connection; it is not a sandbox around Hermes's terminal or a substitute for provider-enforced account and spending limits.
111
+ Hermes owns tools and authentication. MCP tool selection does not constrain its terminal or replace provider-enforced account and spending limits. [Exact prerequisites and connection scope](docs/CONNECTIONS.md)
163
112
 
164
- ## First useful task
113
+ ## Skill packs
165
114
 
166
- > Use galleon-aave-position to inspect my wallet on this Aave V3 market: [chain, market and address]. Show current health factor and the effect of a 20% collateral-price fall. Identify missing reads and keep any repayment or borrow plan unsigned.
115
+ Boomkin installs reviewed releases from [crypto-defi-skills](https://github.com/galleonlabs/crypto-defi-skills): agent plans, prediction markets, infrastructure, data, strategy, liquidity, Hyperliquid, lending, staking, yield, tokenized assets, routing, derivatives, portfolio, security, payments and governance.
167
116
 
168
- Boomkin loads only the relevant skills and provider references. It separates infrastructure readiness, data evidence, protocol workflows, portfolio reporting and transaction review from execution. It uses Hermes's native memory and scheduling when appropriate; a scheduled task retains the same authorization and freshness requirements as an interactive task.
117
+ Each pack installs independently. The [catalog](catalog/skills.json) pins its package, version, immutable source commit and expected skills. Installation checks the copied supporting files; later integrity checks reveal missing or modified instructions and scripts.
169
118
 
170
- `doctor` reports configuration, installed versions and file integrity. Older installations can run `update` once to record file digests; preserve any local skill edits first. `doctor --live` additionally verifies keyless CoinGecko MCP initialization and tool discovery, plus credential-free AIXBT discovery when connected. Neither is proof of a successful model response, authenticated paid data, wallet authority or an executed transaction. Use the data pack's public diagnostic for a first market observation, and the infrastructure pack's RPC diagnostic for a configured chain.
119
+ Fresh onboarding includes all 17 packs. Repeated `--pack` options choose fewer; updates preserve that selection and future packs remain opt-in. Hermes supplies the native runtime, sessions, memory and model setup. [Other harnesses](docs/HARNESSES.md) receive portable skills only.
171
120
 
172
121
  ## Updates and recovery
173
122
 
174
123
  ```bash
175
- bun run boomkin check --directory "$HOME/.boomkin/hermes"
176
- bun run boomkin update --directory "$HOME/.boomkin/hermes"
177
- bun run boomkin doctor --live
178
- bun run boomkin start
124
+ bun install -g boomkin@0.9.1
125
+ boomkin check --directory "$HOME/.boomkin/hermes"
126
+ boomkin update --directory "$HOME/.boomkin/hermes"
127
+ boomkin doctor --directory "$HOME/.boomkin/hermes" --live
179
128
  ```
180
129
 
181
- Pull this repo and run `bun install --frozen-lockfile` when updating Boomkin itself. `update` refreshes the reviewed skill catalog, not the Hermes runtime. Use native Hermes updates separately and rerun the readiness checks afterward. The reviewed runtime pin and installer checksum are in [src/hermes.ts](src/hermes.ts).
130
+ Update Boomkin, selected skill packs and Hermes separately. Preserve local skill edits before updates. [Updates, backups and recovery](docs/UPDATES.md)
182
131
 
183
- Onboarding can be rerun after a failed install or interrupted login. Completed skill installs and existing instructions remain intact. Review any reported operation lock before removing it. Provider failure does not change the approved route or cause an automatic retry of a financial action.
132
+ ## ChatGPT authentication
184
133
 
185
- See [updates and recovery](docs/UPDATES.md) for pack selection, backups and troubleshooting. Keep credentials, private evidence and generated profiles outside this repository.
134
+ Use `boomkin chatgpt --action login` and `--action status` for native Hermes ChatGPT OAuth. Model selection stays with Hermes. [The authentication guide](docs/CHATGPT.md) distinguishes sign-in, partner plan consent and verified usage attribution.
186
135
 
187
136
  ## Contributing
188
137
 
189
- Bug reports, clearer guides, new workflows and focused pull requests are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md) for setup and the checks relevant to your change. Report a reproducible problem in [GitHub Issues](https://github.com/galleonlabs/boomkin/issues); use [private reporting](SECURITY.md) for security concerns.
138
+ Bug reports, clearer guides and focused pull requests are welcome. [Contributing guide](CONTRIBUTING.md) · [Issues](https://github.com/galleonlabs/boomkin/issues) · [Private security reporting](SECURITY.md)
190
139
 
191
140
  ### Local development
192
141
 
@@ -194,17 +143,12 @@ Bug reports, clearer guides, new workflows and focused pull requests are welcome
194
143
  bun install --frozen-lockfile
195
144
  bun run check
196
145
  bun run build
197
- bun run smoke
198
146
  ```
199
147
 
200
- The compatibility smoke checks fresh setup/update and independent pack selection. [Native Hermes smoke](scripts/hermes-native-smoke.py) additionally checks the actual runtime's profile, SOUL, MCP configuration and tool filtering in a temporary home, using a local mock MCP. `--public` adds a keyless CoinGecko discovery check. No model or wallet action is part of these checks.
148
+ Run the [change-specific checks](CONTRIBUTING.md#work-locally) before a pull request. Agents can start with [the documentation index](docs/AGENT-INDEX.md) and [AGENTS.md](AGENTS.md).
201
149
 
202
150
  ## License and credit
203
151
 
204
- [MIT licensed](LICENSE), with the copyright and permission notice retained when reusing copies or substantial portions. Created by [Andrew Wilkinson](https://andrewwilkinson.io) and [Galleon Labs](https://github.com/galleonlabs).
205
-
206
- See [reuse and attribution](ATTRIBUTION.md) for a ready-to-copy credit line. If Boomkin helps your work, [a star on the original repository](https://github.com/galleonlabs/boomkin) is appreciated and entirely optional.
207
-
208
- ## ChatGPT authentication
152
+ [MIT licensed](LICENSE). Created by [Andrew Wilkinson](https://andrewwilkinson.io) and [Galleon Labs](https://github.com/galleonlabs). Preserve copyright and license notices when reusing the project; [attribution guidance](ATTRIBUTION.md) includes an optional credit line. A repository star is appreciated and entirely optional.
209
153
 
210
- Use `bun run boomkin chatgpt --action login` for native Hermes ChatGPT OAuth, `--action status` to inspect it, and `--action model` for catalog-supported selection including GPT-6.1 Sol when available. [ChatGPT onboarding and verification](docs/CHATGPT.md) distinguishes native OAuth from partner plan consent and attributed usage. No tokens are copied into Boomkin and the runtime pin is unchanged.
154
+ Documentation copy controls were inspired by [Rare UI](https://www.rareui.com/components/code-block) and implemented independently.