boomkin 0.9.0 → 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 +8 -0
- package/README.md +70 -147
- package/catalog/skills.json +34 -34
- package/catalog/workflows.json +1 -1
- package/dist/cli.js +50 -38
- package/docs/AGENT-INDEX.md +39 -0
- package/docs/CHATGPT.md +7 -3
- package/docs/CONNECTIONS.md +14 -10
- package/docs/GETTING-STARTED.md +77 -0
- package/docs/HARNESSES.md +12 -11
- package/docs/IDENTITY.md +2 -2
- package/docs/PROJECTS.md +2 -0
- package/docs/UPDATES.md +52 -56
- package/docs/WEBSITE.md +1 -1
- package/docs/WORKFLOWS.md +3 -1
- package/docs/assets/boomkin-hero.svg +14 -0
- package/llms.txt +34 -0
- package/package.json +15 -3
package/dist/cli.js
CHANGED
|
@@ -7233,7 +7233,7 @@ var init_workflows = __esm(() => {
|
|
|
7233
7233
|
id: "hyperliquid-risk",
|
|
7234
7234
|
protocol: "Hyperliquid",
|
|
7235
7235
|
title: "Review a Hyperliquid account before trading",
|
|
7236
|
-
skill: "hyperliquid-
|
|
7236
|
+
skill: "hyperliquid-monitor",
|
|
7237
7237
|
pack: "hyperliquid-skills",
|
|
7238
7238
|
inputs: [
|
|
7239
7239
|
"Public account address and venue/market",
|
|
@@ -7559,8 +7559,8 @@ var skills_default = {
|
|
|
7559
7559
|
id: "lp-skills",
|
|
7560
7560
|
source: "galleonlabs/crypto-defi-skills",
|
|
7561
7561
|
description: "Agent skills and deterministic tools for Uniswap and Aerodrome liquidity provision.",
|
|
7562
|
-
version: "0.6.
|
|
7563
|
-
revision: "
|
|
7562
|
+
version: "0.6.1",
|
|
7563
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7564
7564
|
skills: [
|
|
7565
7565
|
"aerodrome-slipstream",
|
|
7566
7566
|
"lp-analyze",
|
|
@@ -7578,8 +7578,8 @@ var skills_default = {
|
|
|
7578
7578
|
id: "hyperliquid-skills",
|
|
7579
7579
|
source: "galleonlabs/crypto-defi-skills",
|
|
7580
7580
|
description: "Agent skills for Hyperliquid setup, market analysis, trade planning and execution, monitoring, and performance review.",
|
|
7581
|
-
version: "0.3.
|
|
7582
|
-
revision: "
|
|
7581
|
+
version: "0.3.5",
|
|
7582
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7583
7583
|
skills: [
|
|
7584
7584
|
"hyperliquid-analyze",
|
|
7585
7585
|
"hyperliquid-engineer",
|
|
@@ -7596,8 +7596,8 @@ var skills_default = {
|
|
|
7596
7596
|
id: "defi-infra-skills",
|
|
7597
7597
|
source: "galleonlabs/crypto-defi-skills",
|
|
7598
7598
|
description: "RPC, wallet and Hermes infrastructure skills with read-only readiness diagnostics.",
|
|
7599
|
-
version: "0.4.
|
|
7600
|
-
revision: "
|
|
7599
|
+
version: "0.4.1",
|
|
7600
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7601
7601
|
skills: [
|
|
7602
7602
|
"galleon-coinbase-agentkit-readiness",
|
|
7603
7603
|
"galleon-defi-infra"
|
|
@@ -7609,8 +7609,8 @@ var skills_default = {
|
|
|
7609
7609
|
id: "defi-data-skills",
|
|
7610
7610
|
source: "galleonlabs/crypto-defi-skills",
|
|
7611
7611
|
description: "Capture timestamped market evidence, compare public sources, retrieve daily history and screen DeFi yields.",
|
|
7612
|
-
version: "0.6.
|
|
7613
|
-
revision: "
|
|
7612
|
+
version: "0.6.1",
|
|
7613
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7614
7614
|
skills: [
|
|
7615
7615
|
"galleon-coingecko-token-research",
|
|
7616
7616
|
"galleon-defi-data",
|
|
@@ -7624,8 +7624,8 @@ var skills_default = {
|
|
|
7624
7624
|
id: "defi-lending-skills",
|
|
7625
7625
|
source: "galleonlabs/crypto-defi-skills",
|
|
7626
7626
|
description: "Research lending markets, plan borrowing and monitor liquidation exposure.",
|
|
7627
|
-
version: "0.3.
|
|
7628
|
-
revision: "
|
|
7627
|
+
version: "0.3.1",
|
|
7628
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7629
7629
|
skills: [
|
|
7630
7630
|
"galleon-aave-position",
|
|
7631
7631
|
"galleon-aave-v4",
|
|
@@ -7640,8 +7640,8 @@ var skills_default = {
|
|
|
7640
7640
|
id: "defi-staking-skills",
|
|
7641
7641
|
source: "galleonlabs/crypto-defi-skills",
|
|
7642
7642
|
description: "Plan liquid staking, restaking and queued withdrawals.",
|
|
7643
|
-
version: "0.2.
|
|
7644
|
-
revision: "
|
|
7643
|
+
version: "0.2.1",
|
|
7644
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7645
7645
|
skills: [
|
|
7646
7646
|
"galleon-defi-staking",
|
|
7647
7647
|
"galleon-lido-withdrawals"
|
|
@@ -7653,8 +7653,8 @@ var skills_default = {
|
|
|
7653
7653
|
id: "defi-yield-skills",
|
|
7654
7654
|
source: "galleonlabs/crypto-defi-skills",
|
|
7655
7655
|
description: "Evaluate vaults and yield tokens, including liquidity and maturity.",
|
|
7656
|
-
version: "0.2.
|
|
7657
|
-
revision: "
|
|
7656
|
+
version: "0.2.1",
|
|
7657
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7658
7658
|
skills: [
|
|
7659
7659
|
"galleon-defi-yield",
|
|
7660
7660
|
"galleon-pendle-maturity",
|
|
@@ -7667,8 +7667,8 @@ var skills_default = {
|
|
|
7667
7667
|
id: "defi-tokenized-assets-skills",
|
|
7668
7668
|
source: "galleonlabs/crypto-defi-skills",
|
|
7669
7669
|
description: "Research tokenized assets, eligibility and issuer settlement.",
|
|
7670
|
-
version: "0.1.
|
|
7671
|
-
revision: "
|
|
7670
|
+
version: "0.1.3",
|
|
7671
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7672
7672
|
skills: [
|
|
7673
7673
|
"galleon-defi-tokenized-assets"
|
|
7674
7674
|
],
|
|
@@ -7679,8 +7679,8 @@ var skills_default = {
|
|
|
7679
7679
|
id: "defi-routing-skills",
|
|
7680
7680
|
source: "galleonlabs/crypto-defi-skills",
|
|
7681
7681
|
description: "Compare swaps and bridges and track cross-chain settlement.",
|
|
7682
|
-
version: "0.3.
|
|
7683
|
-
revision: "
|
|
7682
|
+
version: "0.3.1",
|
|
7683
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7684
7684
|
skills: [
|
|
7685
7685
|
"galleon-defi-routing",
|
|
7686
7686
|
"lifi-cross-chain",
|
|
@@ -7693,8 +7693,8 @@ var skills_default = {
|
|
|
7693
7693
|
id: "defi-derivatives-skills",
|
|
7694
7694
|
source: "galleonlabs/crypto-defi-skills",
|
|
7695
7695
|
description: "Plan derivatives positions and reconcile venue execution.",
|
|
7696
|
-
version: "0.1.
|
|
7697
|
-
revision: "
|
|
7696
|
+
version: "0.1.5",
|
|
7697
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7698
7698
|
skills: [
|
|
7699
7699
|
"galleon-defi-derivatives"
|
|
7700
7700
|
],
|
|
@@ -7705,8 +7705,8 @@ var skills_default = {
|
|
|
7705
7705
|
id: "defi-portfolio-skills",
|
|
7706
7706
|
source: "galleonlabs/crypto-defi-skills",
|
|
7707
7707
|
description: "Reconcile DeFi assets, liabilities, cash flows and exposure.",
|
|
7708
|
-
version: "0.2.
|
|
7709
|
-
revision: "
|
|
7708
|
+
version: "0.2.1",
|
|
7709
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7710
7710
|
skills: [
|
|
7711
7711
|
"galleon-defi-portfolio"
|
|
7712
7712
|
],
|
|
@@ -7717,8 +7717,8 @@ var skills_default = {
|
|
|
7717
7717
|
id: "defi-security-skills",
|
|
7718
7718
|
source: "galleonlabs/crypto-defi-skills",
|
|
7719
7719
|
description: "Investigate token risks, compare evidence and review transaction permissions.",
|
|
7720
|
-
version: "0.2.
|
|
7721
|
-
revision: "
|
|
7720
|
+
version: "0.2.3",
|
|
7721
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7722
7722
|
skills: [
|
|
7723
7723
|
"galleon-defi-security",
|
|
7724
7724
|
"galleon-defi-security-token-diligence"
|
|
@@ -7730,8 +7730,8 @@ var skills_default = {
|
|
|
7730
7730
|
id: "defi-payments-skills",
|
|
7731
7731
|
source: "galleonlabs/crypto-defi-skills",
|
|
7732
7732
|
description: "Plan stablecoin payments, x402 purchases and token streams.",
|
|
7733
|
-
version: "0.2.
|
|
7734
|
-
revision: "
|
|
7733
|
+
version: "0.2.1",
|
|
7734
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7735
7735
|
skills: [
|
|
7736
7736
|
"galleon-defi-payments",
|
|
7737
7737
|
"galleon-sablier-streams",
|
|
@@ -7744,8 +7744,8 @@ var skills_default = {
|
|
|
7744
7744
|
id: "defi-governance-skills",
|
|
7745
7745
|
source: "galleonlabs/crypto-defi-skills",
|
|
7746
7746
|
description: "Research proposals, prepare votes and track governance execution.",
|
|
7747
|
-
version: "0.1.
|
|
7748
|
-
revision: "
|
|
7747
|
+
version: "0.1.3",
|
|
7748
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7749
7749
|
skills: [
|
|
7750
7750
|
"galleon-defi-governance"
|
|
7751
7751
|
],
|
|
@@ -7756,8 +7756,8 @@ var skills_default = {
|
|
|
7756
7756
|
id: "defi-strategy-skills",
|
|
7757
7757
|
source: "galleonlabs/crypto-defi-skills",
|
|
7758
7758
|
description: "Test daily spot rules with costs, cash flows, drawdown and a reproducible buy-and-hold benchmark.",
|
|
7759
|
-
version: "0.1.
|
|
7760
|
-
revision: "
|
|
7759
|
+
version: "0.1.1",
|
|
7760
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7761
7761
|
skills: [
|
|
7762
7762
|
"galleon-defi-strategy-backtest"
|
|
7763
7763
|
],
|
|
@@ -7768,8 +7768,8 @@ var skills_default = {
|
|
|
7768
7768
|
id: "defi-agent-skills",
|
|
7769
7769
|
source: "galleonlabs/crypto-defi-skills",
|
|
7770
7770
|
description: "Construct unsigned DeFi plans and verify exact transaction simulation evidence.",
|
|
7771
|
-
version: "0.1.
|
|
7772
|
-
revision: "
|
|
7771
|
+
version: "0.1.1",
|
|
7772
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7773
7773
|
skills: [
|
|
7774
7774
|
"galleon-defi-agent-plan",
|
|
7775
7775
|
"galleon-defi-agent-simulate"
|
|
@@ -7781,8 +7781,8 @@ var skills_default = {
|
|
|
7781
7781
|
id: "defi-prediction-skills",
|
|
7782
7782
|
source: "galleonlabs/crypto-defi-skills",
|
|
7783
7783
|
description: "Research prediction market order books and reconcile resolution without signing or trading.",
|
|
7784
|
-
version: "0.1.
|
|
7785
|
-
revision: "
|
|
7784
|
+
version: "0.1.1",
|
|
7785
|
+
revision: "9fe67c24efc0fd5796066605b29576f3b8f2de94",
|
|
7786
7786
|
skills: [
|
|
7787
7787
|
"galleon-prediction-market-research",
|
|
7788
7788
|
"galleon-prediction-market-resolution"
|
|
@@ -7795,7 +7795,7 @@ var skills_default = {
|
|
|
7795
7795
|
// package.json
|
|
7796
7796
|
var package_default = {
|
|
7797
7797
|
name: "boomkin",
|
|
7798
|
-
version: "0.9.
|
|
7798
|
+
version: "0.9.1",
|
|
7799
7799
|
description: "Your open-source DeFi desk: native Hermes research projects, verifiable evidence and independent financial skills.",
|
|
7800
7800
|
type: "module",
|
|
7801
7801
|
license: "MIT",
|
|
@@ -7830,7 +7830,8 @@ var package_default = {
|
|
|
7830
7830
|
"README.md",
|
|
7831
7831
|
"CHANGELOG.md",
|
|
7832
7832
|
"LICENSE",
|
|
7833
|
-
"ATTRIBUTION.md"
|
|
7833
|
+
"ATTRIBUTION.md",
|
|
7834
|
+
"llms.txt"
|
|
7834
7835
|
],
|
|
7835
7836
|
engines: {
|
|
7836
7837
|
bun: ">=1.3.12"
|
|
@@ -7846,7 +7847,18 @@ var package_default = {
|
|
|
7846
7847
|
author: "Galleon Labs",
|
|
7847
7848
|
publishConfig: {
|
|
7848
7849
|
access: "public"
|
|
7849
|
-
}
|
|
7850
|
+
},
|
|
7851
|
+
keywords: [
|
|
7852
|
+
"defi",
|
|
7853
|
+
"crypto",
|
|
7854
|
+
"ai-agent",
|
|
7855
|
+
"agent-skills",
|
|
7856
|
+
"hermes",
|
|
7857
|
+
"mcp",
|
|
7858
|
+
"research",
|
|
7859
|
+
"backtesting",
|
|
7860
|
+
"galleon"
|
|
7861
|
+
]
|
|
7850
7862
|
};
|
|
7851
7863
|
|
|
7852
7864
|
// src/cli.ts
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Boomkin documentation index for agents
|
|
2
|
+
|
|
3
|
+
Boomkin prepares a native Hermes DeFi research profile with reviewed Galleon skills. Start with the human [README](../README.md), then read only the guides needed for the user's task. Repository contributors also read [AGENTS.md](../AGENTS.md).
|
|
4
|
+
|
|
5
|
+
## Route the task
|
|
6
|
+
|
|
7
|
+
| User intent | Read | First command or artifact |
|
|
8
|
+
| --- | --- | --- |
|
|
9
|
+
| Try before installation | [Live strategy lab](https://galleonlabs.github.io/boomkin/lab/) | Dated or synthetic daily simulation in the browser |
|
|
10
|
+
| Prepare an agent and model | [Getting started](GETTING-STARTED.md) | `boomkin onboard`; `boomkin doctor --live` |
|
|
11
|
+
| Choose a protocol job | [Workflows](WORKFLOWS.md) | `boomkin workflows --workflow <id> --json` |
|
|
12
|
+
| Find a tool by capability/cost | [Providers](PROVIDERS.md) | `boomkin providers --search <term> --json` |
|
|
13
|
+
| Configure a supported integration | [Connections](CONNECTIONS.md) | `boomkin connect --provider <id>` |
|
|
14
|
+
| Use native ChatGPT authentication | [ChatGPT](CHATGPT.md) | `boomkin chatgpt --action status` |
|
|
15
|
+
| Preserve a research question and evidence | [Projects](PROJECTS.md) | Create with an input JSON file; preview with `run --dry-run` |
|
|
16
|
+
| Maintain or repair a profile | [Updates](UPDATES.md) | `boomkin check --directory <profile>` |
|
|
17
|
+
| Add skills to another harness | [Harness compatibility](HARNESSES.md) | `boomkin setup --harness <id> --directory <workspace>` |
|
|
18
|
+
| Review the agent's instruction routing | [Identity](IDENTITY.md) | [src/core.ts](../src/core.ts) |
|
|
19
|
+
| Change the CLI, catalog or docs | [Contributing](../CONTRIBUTING.md) | Native checks appropriate to the changed files |
|
|
20
|
+
| Build or verify the public website | [Website delivery](WEBSITE.md) | Exact Website run plus public `release.json` and affected UI |
|
|
21
|
+
|
|
22
|
+
## Read the authoritative artifacts
|
|
23
|
+
|
|
24
|
+
- [catalog/skills.json](../catalog/skills.json): 17 independently published packs, 48 expected skill IDs, immutable source pins and npm versions.
|
|
25
|
+
- [catalog/workflows.json](../catalog/workflows.json): 27 workflow IDs, selected pack/skill, inputs, outputs and access requirements. [src/workflows.ts](../src/workflows.ts) validates and queries these contracts.
|
|
26
|
+
- [catalog/providers.json](../catalog/providers.json): 60 discovery entries, sources, review dates, authorship, cost and authority. Discovery entries do not all have native integrations.
|
|
27
|
+
- [src/hermes.ts](../src/hermes.ts): native runtime/installer pin and launch/authentication contracts.
|
|
28
|
+
- [src/projects.ts](../src/projects.ts): project and evidence schemas, run states and validation limits.
|
|
29
|
+
- [Public catalog](https://galleonlabs.github.io/boomkin/assets/catalog.json), [provider catalog](https://galleonlabs.github.io/boomkin/assets/providers.json) and [release manifest](https://galleonlabs.github.io/boomkin/release.json): deployed revision and public documentation data.
|
|
30
|
+
|
|
31
|
+
The installed/checked-out CLI catalog and deployed website can reflect different revisions during a release. `update` fetches the public Boomkin source catalog; `--offline-catalog` uses the installed/checked-out copy and still needs access to download pinned sources. Preserve exact package, version and source identity when reporting results.
|
|
32
|
+
|
|
33
|
+
## Keep the operating boundary explicit
|
|
34
|
+
|
|
35
|
+
Local workflow/provider discovery, project creation and previews make no model or data call. `doctor --live` performs credential-free public MCP initialization and tool discovery. A live project run uses native Hermes and its configured model/tools. CoinGecko is the sole default connection; optional providers can consume credits or grant broader account permissions.
|
|
36
|
+
|
|
37
|
+
Skills and MCP selection are instructions/configuration, not a sandbox around Hermes's terminal. Use account-enforced scopes and spending limits. Never treat file installation, model login, tool discovery, simulation, scheduling configuration or `ready-for-review` as transaction execution or verified settlement. Required evidence and limits are documented beside each workflow and in the project contract.
|
|
38
|
+
|
|
39
|
+
Use `boomkin --help` for command syntax. From source, use `bun run boomkin`. Read [SECURITY.md](../SECURITY.md) before publishing a security report; keep secrets and private profiles out of repository changes.
|
package/docs/CHATGPT.md
CHANGED
|
@@ -1,13 +1,17 @@
|
|
|
1
1
|
# ChatGPT in native Hermes
|
|
2
2
|
|
|
3
|
+
Use the selected Hermes profile for native sign-in and model selection. [Getting started](GETTING-STARTED.md) · [Model and runtime setup](CONNECTIONS.md#model-and-runtime)
|
|
4
|
+
|
|
5
|
+
Examples use the installed `boomkin` command; from source, use `bun run boomkin`.
|
|
6
|
+
|
|
3
7
|
[OpenAI lists Hermes Agent as a ChatGPT plan-usage partner](https://learn.chatgpt.com/docs/sign-in-with-chatgpt). Account sign-in, permission to consume plan usage, a successful inference and usage attributed to Hermes are separate milestones. Boomkin is an onboarding layer, not a separately registered OpenAI partner.
|
|
4
8
|
|
|
5
9
|
Boomkin retains reviewed Hermes 0.21.5 at `f97608f178d1ffeca59860195ab7da295f7c8e5f`. Its native `auth add openai-codex --type oauth` supports a fresh ChatGPT device login, profile-native credential pools and refresh; `auth status` reports authentication. Its source uses the Codex OAuth client and Codex inference route. This proves native ChatGPT OAuth capability; it does **not** prove the new Hermes partner plan-consent or per-app attribution path. Use the [official Nous portal](https://portal.nousresearch.com/) for the partner connection and review its actual permission screen. Do not replace the pinned runtime or invent partner client IDs/endpoints to bridge that gap.
|
|
6
10
|
|
|
7
11
|
```sh
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
12
|
+
boomkin chatgpt --action login --directory /absolute/path/to/boomkin-profile
|
|
13
|
+
boomkin chatgpt --action status --directory /absolute/path/to/boomkin-profile
|
|
14
|
+
boomkin chatgpt --action model --directory /absolute/path/to/boomkin-profile
|
|
11
15
|
```
|
|
12
16
|
|
|
13
17
|
Login uses native Hermes authentication with automatic browser opening disabled. Complete the displayed device flow with the intended personal ChatGPT account. Choose fresh login if Hermes offers credentials from other apps. Boomkin never reads or copies Codex credentials and maintains no token store; native Hermes owns credentials in the selected profile. Model setup remains native: choose GPT-6.1 Sol only if the provider's catalog offers it. Availability and supported reasoning levels vary; never force an unavailable slug or route silently through a paid API fallback.
|
package/docs/CONNECTIONS.md
CHANGED
|
@@ -1,10 +1,14 @@
|
|
|
1
1
|
# Boomkin connections
|
|
2
2
|
|
|
3
|
-
Hermes owns authentication, tools and execution. Boomkin prepares an isolated profile
|
|
3
|
+
Hermes owns authentication, tools and execution. Boomkin prepares an isolated profile with public CoinGecko as its sole default connection. Choose optional tools by the access, cost and authority your task needs. Skill instructions do not create financial authority.
|
|
4
|
+
|
|
5
|
+
[Getting started](GETTING-STARTED.md) · [Provider discovery](PROVIDERS.md) · [Saved projects](PROJECTS.md)
|
|
6
|
+
|
|
7
|
+
Provider-specific review dates and limits appear below. The broader discovery catalog was reviewed on October 8, 2026; source review and public MCP discovery do not establish authenticated account access.
|
|
4
8
|
|
|
5
9
|
## Model and runtime
|
|
6
10
|
|
|
7
|
-
`
|
|
11
|
+
`boomkin onboard` runs the official pinned Hermes installer when needed and opens `hermes setup model` with the selected `HERMES_HOME`. Use `boomkin model` to revisit setup, and `boomkin start` for native chat. From a source checkout, use `bun run boomkin`. Model keys, OAuth and local models use Hermes's facilities. A configured model name or CLI version is not proof of authentication.
|
|
8
12
|
|
|
9
13
|
Hermes v0.21.5 (upstream tag `v2026.9.24`) at [the reviewed source](https://github.com/NousResearch/hermes-agent/tree/f97608f178d1ffeca59860195ab7da295f7c8e5f) was tested. Boomkin pins the official installer and runtime for a fresh install. Existing installations are preserved. Native setup supports optional browser, tools and messaging features; configure those through Hermes rather than a second runtime.
|
|
10
14
|
|
|
@@ -16,7 +20,7 @@ Use `boomkin providers --capability Data --access keyless --json` to discover da
|
|
|
16
20
|
|
|
17
21
|
CoinGecko public MCP is `https://mcp.api.coingecko.com/mcp`. Onboarding adds only `execute` and `search_docs`, the two tools returned during the live review, with `trust: untrusted` and resource/prompt utilities disabled. `execute` runs code against CoinGecko's hosted data SDK; it is not arbitrary local code execution. Use bounded queries with explicit asset IDs, currency and timestamps. Pricing, limits and tool discovery can change.
|
|
18
22
|
|
|
19
|
-
`
|
|
23
|
+
`boomkin doctor --live` checks initialization and tool discovery without calling a model or a paid service. A separate market read is available from the installed data skill:
|
|
20
24
|
|
|
21
25
|
```bash
|
|
22
26
|
node "$HOME/.boomkin/hermes/skills/galleon-defi-data/scripts/price-check.mjs" --provider coingecko --id ethereum
|
|
@@ -43,8 +47,8 @@ When this connection is enabled, `doctor --live` checks its keyless initializati
|
|
|
43
47
|
Store `AIXBT_API_KEY` in the selected Hermes profile's private `.env` using native secret facilities, then run:
|
|
44
48
|
|
|
45
49
|
```bash
|
|
46
|
-
|
|
47
|
-
|
|
50
|
+
boomkin connect --provider aixbt
|
|
51
|
+
boomkin doctor --live
|
|
48
52
|
```
|
|
49
53
|
|
|
50
54
|
Pass the same `--directory` to both commands when using a custom profile. Boomkin writes the official Streamable HTTP endpoint `https://api.aixbt.tech/mcp` and the literal header reference `Authorization: Bearer ${AIXBT_API_KEY}`. Hermes resolves that reference from its environment; Boomkin never copies the key into YAML, arguments, or diagnostic output. The API v3 base `https://api.aixbt.tech/v3` is for REST calls, not the MCP server URL. Existing conflicting MCP settings are preserved and reported for review.
|
|
@@ -58,7 +62,7 @@ Use the installed `galleon-defi-data` skill for AIXBT research alongside asset i
|
|
|
58
62
|
## Alchemy and RPC
|
|
59
63
|
|
|
60
64
|
```bash
|
|
61
|
-
|
|
65
|
+
boomkin connect --provider alchemy
|
|
62
66
|
```
|
|
63
67
|
|
|
64
68
|
The command hands OAuth and tool selection to native Hermes at `https://mcp.alchemy.com/mcp`, then marks the resulting server untrusted. Select the intended app before RPC/data calls. Start with the necessary read tools; app administration and wallet session/transaction tools are separate choices. API-key access through the official CLI is distinct from hosted MCP OAuth. See [Alchemy agent tools](https://www.alchemy.com/ai-agents).
|
|
@@ -68,7 +72,7 @@ For the infrastructure diagnostic, configure `DEFI_RPC_URL` through the selected
|
|
|
68
72
|
## DeFiLlama
|
|
69
73
|
|
|
70
74
|
```bash
|
|
71
|
-
|
|
75
|
+
boomkin connect --provider defillama
|
|
72
76
|
```
|
|
73
77
|
|
|
74
78
|
The official endpoint `https://mcp.defillama.com/mcp` requires OAuth and an API subscription. Requests consume credits. Its single-client restriction can disconnect an existing MCP client; choose the intended agent before authorizing. Boomkin does not authenticate this paid provider during default onboarding. The data pack also documents bounded public REST alternatives with separate coverage. See [the official MCP page](https://defillama.com/mcp).
|
|
@@ -76,8 +80,8 @@ The official endpoint `https://mcp.defillama.com/mcp` requires OAuth and an API
|
|
|
76
80
|
## Coinbase account
|
|
77
81
|
|
|
78
82
|
```bash
|
|
79
|
-
|
|
80
|
-
|
|
83
|
+
boomkin connect --provider coinbase
|
|
84
|
+
boomkin connect --provider coinbase --key-file /absolute/path/to/scoped-key.json
|
|
81
85
|
```
|
|
82
86
|
|
|
83
87
|
This uses `@coinbase/coinbase-cli@0.0.7`, Node.js 22+ and the native `coinbase mcp` stdio server. Its remote account MCP restricts supported harnesses, so Boomkin uses the local path. The configuration initially exposes only balance, portfolio listing/details, product listing/details and fee reads. It grants no trading or transfer tool through this MCP connection.
|
|
@@ -123,7 +127,7 @@ Provider-specific instructions and source pins live in the infrastructure and da
|
|
|
123
127
|
## Tenderly transaction review
|
|
124
128
|
|
|
125
129
|
```bash
|
|
126
|
-
|
|
130
|
+
boomkin connect --provider tenderly
|
|
127
131
|
```
|
|
128
132
|
|
|
129
133
|
Boomkin uses native Hermes OAuth and tool selection for the [official Tenderly MCP](https://docs.tenderly.co/ai-tools/overview) at `https://mcp.tenderly.co/mcp`. Tenderly documents paid-plan enablement and an account/project prerequisite. The command connects the provider; it does not purchase access, simulate a transaction or broadcast one.
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# Your first Boomkin session
|
|
2
|
+
|
|
3
|
+
[Try the browser lab](https://galleonlabs.github.io/boomkin/lab/) to inspect the strategy engine before installing. For an agent that can research your own question, prepare a native Hermes profile below.
|
|
4
|
+
|
|
5
|
+
[README](../README.md#get-started) · [Choose a workflow](WORKFLOWS.md) · [Connect a provider](CONNECTIONS.md) · [Agent index](AGENT-INDEX.md)
|
|
6
|
+
|
|
7
|
+
## Install and start
|
|
8
|
+
|
|
9
|
+
Use macOS or Linux with [Bun](https://bun.sh) 1.3.12+ and Git. Keep Bun's global bin directory on your shell path. Windows users can use WSL2; an existing native Windows Hermes installation can also be reused through its official flow.
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
bun install -g boomkin@0.9.1
|
|
13
|
+
boomkin onboard
|
|
14
|
+
boomkin doctor --live
|
|
15
|
+
boomkin start
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
Onboarding prepares `~/.boomkin/hermes`, installs the selected reviewed skill packs, writes Boomkin's initial identity and instructions, configures public CoinGecko MCP and opens native Hermes model setup. A fresh default profile includes all 17 packs and 48 skills. Select your model provider and complete its native sign-in. Existing instructions and unrelated settings are preserved; conflicting named MCP settings are reported for review.
|
|
19
|
+
|
|
20
|
+
Your account or local model configuration supplies inference. Optional services have their own credential, subscription and usage requirements. Onboarding makes no model call or paid data request, creates no wallet and starts no background service.
|
|
21
|
+
|
|
22
|
+
## Ask a public-data question
|
|
23
|
+
|
|
24
|
+
In the Hermes chat:
|
|
25
|
+
|
|
26
|
+
> Use galleon-coingecko-token-research. Resolve CoinGecko ID ethereum and capture a public ETH/USD market observation. Show asset identity, source URL, observation time and freshness limits. Mark unavailable fields clearly. Keep the task read-only.
|
|
27
|
+
|
|
28
|
+
Expect a bounded observation with its sources and limitations, or a useful explanation of missing access. A configured model is not proof of successful inference, and public MCP discovery is not proof of a data read. `doctor --live` initializes CoinGecko and lists its tools; it also probes optional Blockscout and AIXBT discovery when configured, without credentials or protected data calls.
|
|
29
|
+
|
|
30
|
+
For repeatable questions, [save a project](PROJECTS.md). Creation and preview run locally; a live project run uses the selected model and tools.
|
|
31
|
+
|
|
32
|
+
## Choose a profile or a single workflow
|
|
33
|
+
|
|
34
|
+
Use the same directory with every later command:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
boomkin onboard --workflow aave-health --directory "$HOME/aave-desk"
|
|
38
|
+
boomkin doctor --directory "$HOME/aave-desk" --live
|
|
39
|
+
boomkin start --directory "$HOME/aave-desk"
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
`--workflow` selects one task's pack for updates. On an existing profile, previously copied skills stay in place. Use distinct directories when projects need distinct tool access.
|
|
43
|
+
|
|
44
|
+
| Option | When to use it |
|
|
45
|
+
| --- | --- |
|
|
46
|
+
| `--dry-run` | Preview onboarding without writing files or starting setup |
|
|
47
|
+
| `--skip-model-setup` | Prepare the profile before an interactive login |
|
|
48
|
+
| `--no-install` | Reuse an existing Hermes executable; fail if it is missing |
|
|
49
|
+
| Repeated `--pack <id>` | Choose the complete set of packs to install and update |
|
|
50
|
+
| `--all-packs` | Deliberately expand an existing profile to the current catalog |
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
boomkin onboard --directory "$HOME/research-desk" --dry-run
|
|
54
|
+
boomkin onboard --directory "$HOME/research-desk" --skip-model-setup
|
|
55
|
+
boomkin model --directory "$HOME/research-desk"
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Understand the runtime
|
|
59
|
+
|
|
60
|
+
Hermes owns chat, tools, memory, sessions, scheduling and model authentication. Boomkin supplies reviewed financial procedures, source pins, installation checks and research projects. Other harness adapters install [skills only](HARNESSES.md).
|
|
61
|
+
|
|
62
|
+
A fresh runtime installation uses reviewed Hermes 0.21.5, upstream tag `v2026.9.24`, through its pinned official installer. A working existing Hermes installation at 0.21.0 or newer is reused. Browser/computer-use dependencies are skipped initially; configure optional features through native Hermes setup. The reviewed runtime source and installer checksum live in [src/hermes.ts](../src/hermes.ts).
|
|
63
|
+
|
|
64
|
+
CoinGecko is the sole onboarding data connection. Optional provider setup stays explicit; [provider discovery](PROVIDERS.md) separates source references from the smaller native connection list. Tool availability, account authority and financial execution are different outcomes.
|
|
65
|
+
|
|
66
|
+
## Work from source
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
git clone https://github.com/galleonlabs/boomkin.git
|
|
70
|
+
cd boomkin
|
|
71
|
+
bun install --frozen-lockfile
|
|
72
|
+
bun run boomkin onboard
|
|
73
|
+
bun run boomkin doctor --live
|
|
74
|
+
bun run boomkin start
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
In a checkout, replace `boomkin` in the guides with `bun run boomkin`. Use [CONTRIBUTING.md](../CONTRIBUTING.md) for development checks and [updates and recovery](UPDATES.md) for maintenance. Keep profiles, credentials and private evidence outside the repository.
|
package/docs/HARNESSES.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# Advanced skill-only compatibility
|
|
2
2
|
|
|
3
|
-
Boomkin's
|
|
3
|
+
Boomkin's complete onboarding flow uses native Hermes; start with the [getting-started guide](GETTING-STARTED.md). The adapters below install portable skills in other harnesses. Models, credentials, tools and hosting remain with your selected harness.
|
|
4
|
+
|
|
5
|
+
Examples use the installed `boomkin` command. From a source checkout, replace it with `bun run boomkin`.
|
|
4
6
|
|
|
5
7
|
## Choose a harness
|
|
6
8
|
|
|
@@ -13,14 +15,14 @@ Install the runtime from its official source; Boomkin does not vendor it.
|
|
|
13
15
|
For a complete Boomkin profile, use native onboarding:
|
|
14
16
|
|
|
15
17
|
```bash
|
|
16
|
-
|
|
17
|
-
|
|
18
|
+
boomkin onboard --directory "$HOME/boomkin-hermes"
|
|
19
|
+
boomkin start --directory "$HOME/boomkin-hermes"
|
|
18
20
|
```
|
|
19
21
|
|
|
20
22
|
To add only the skills to an existing Hermes home:
|
|
21
23
|
|
|
22
24
|
```bash
|
|
23
|
-
|
|
25
|
+
boomkin setup --harness hermes --directory "$HOME/your-hermes-profile"
|
|
24
26
|
```
|
|
25
27
|
|
|
26
28
|
Boomkin passes that directory as `HERMES_HOME` to the skill installer, which writes to its `skills/` directory. Use your existing native Hermes launch configuration for that profile. Follow [Hermes gateway documentation](https://hermes-agent.nousresearch.com/docs/) for persistent operation.
|
|
@@ -31,8 +33,7 @@ Boomkin passes that directory as `HERMES_HOME` to the skill installer, which wri
|
|
|
31
33
|
|
|
32
34
|
```bash
|
|
33
35
|
bunx eve@latest init "$HOME/boomkin-eve"
|
|
34
|
-
|
|
35
|
-
bun run boomkin setup --harness eve --directory "$HOME/boomkin-eve"
|
|
36
|
+
boomkin setup --harness eve --directory "$HOME/boomkin-eve"
|
|
36
37
|
cd "$HOME/boomkin-eve"
|
|
37
38
|
bunx eve dev
|
|
38
39
|
# When ready to deploy using your Vercel account:
|
|
@@ -51,8 +52,8 @@ Use the actual workspace selected during onboarding:
|
|
|
51
52
|
|
|
52
53
|
```bash
|
|
53
54
|
openclaw onboard
|
|
54
|
-
#
|
|
55
|
-
|
|
55
|
+
# Change the path if your selected workspace differs:
|
|
56
|
+
boomkin setup --harness openclaw --directory "$HOME/.openclaw/workspace"
|
|
56
57
|
openclaw skills list
|
|
57
58
|
```
|
|
58
59
|
|
|
@@ -65,9 +66,9 @@ or remote deployment. Skills alone do not configure an exchange connection.
|
|
|
65
66
|
Install/sign in using the native upstream installer, then:
|
|
66
67
|
|
|
67
68
|
```bash
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
69
|
+
boomkin setup --harness codex --directory "$HOME/boomkin-codex"
|
|
70
|
+
boomkin setup --harness claude --directory "$HOME/boomkin-claude"
|
|
71
|
+
boomkin setup --harness opencode --directory "$HOME/boomkin-opencode"
|
|
71
72
|
```
|
|
72
73
|
|
|
73
74
|
Launch the corresponding agent from its directory. Codex and OpenCode use
|
package/docs/IDENTITY.md
CHANGED
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
Fresh Hermes onboarding creates the Boomkin SOUL and instructions from [src/core.ts](../src/core.ts). Existing user files are preserved. Start with the protocol skill matching the task; use infrastructure and cross-protocol skills when required reads or capabilities are missing.
|
|
4
4
|
|
|
5
|
-
The identity routes lending, staking, yield, tokenized assets, swaps/bridges, derivatives, payments and
|
|
5
|
+
The identity routes lending, staking, yield, tokenized assets, swaps/bridges, derivatives, payments, governance and prediction-market research alongside LP and Hyperliquid. Agent planning constructs unsigned payloads and checks simulation evidence. Portfolio reconciles holdings and performance; security investigates token risks and reviews exact transaction effects and continuing authority. These are selected capabilities, not instructions to invoke every pack.
|
|
6
6
|
|
|
7
7
|
Boomkin runs on native Hermes, preserving its model, memory, tools and scheduling behavior. Skills provide procedures and evidence handoffs; account access and financial authority remain explicit. The name is a nod to the moonkin meme. See [workflow examples](WORKFLOWS.md).
|
|
8
8
|
|
|
9
|
-
Use `
|
|
9
|
+
Use `boomkin workflows` to discover the available tasks and their required inputs; from source, use `bun run boomkin`. [The agent index](AGENT-INDEX.md) maps user intents to the authoritative guides. Existing profiles can adopt this routing deliberately; updates preserve custom instructions.
|
package/docs/PROJECTS.md
CHANGED
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
A project keeps a question, its inputs and successive evidence together. Each run uses native Hermes and writes a separate report and unsigned plan. A completed model response stays `needs-review` until its files pass the evidence checks.
|
|
4
4
|
|
|
5
|
+
[First session](GETTING-STARTED.md) · [Choose a workflow](WORKFLOWS.md) · [Provider access](CONNECTIONS.md)
|
|
6
|
+
|
|
5
7
|
Examples use the installed `boomkin` command. From a source checkout, replace it with `bun run boomkin`.
|
|
6
8
|
|
|
7
9
|
## Create a project
|