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/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-analyze",
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.0",
7563
- revision: "8609564d3a79883ebf515fec201240e90fb271b2",
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.4",
7582
- revision: "b4a020cbc810acabe22a09662cf88137a0907ea6",
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.0",
7600
- revision: "7451b2cb578ce786cbd1e3ee55a4d12ba599739d",
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.0",
7613
- revision: "7451b2cb578ce786cbd1e3ee55a4d12ba599739d",
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.0",
7628
- revision: "7451b2cb578ce786cbd1e3ee55a4d12ba599739d",
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.0",
7644
- revision: "8609564d3a79883ebf515fec201240e90fb271b2",
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.0",
7657
- revision: "8609564d3a79883ebf515fec201240e90fb271b2",
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.2",
7671
- revision: "d5d8439bd5bd1fec88994a6ca0448cde11e31747",
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.0",
7683
- revision: "7451b2cb578ce786cbd1e3ee55a4d12ba599739d",
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.4",
7697
- revision: "470508005adb1ed3fe3a1e758598170e671b7db3",
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.0",
7709
- revision: "7451b2cb578ce786cbd1e3ee55a4d12ba599739d",
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.2",
7721
- revision: "d5d8439bd5bd1fec88994a6ca0448cde11e31747",
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.0",
7734
- revision: "7451b2cb578ce786cbd1e3ee55a4d12ba599739d",
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.2",
7748
- revision: "d5d8439bd5bd1fec88994a6ca0448cde11e31747",
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.0",
7760
- revision: "72b0d85df41c2c2a6e0525d94b245faa6d11e5d4",
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.0",
7772
- revision: "7451b2cb578ce786cbd1e3ee55a4d12ba599739d",
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.0",
7785
- revision: "7451b2cb578ce786cbd1e3ee55a4d12ba599739d",
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.0",
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
- bun run boomkin chatgpt --action login --directory /absolute/path/to/boomkin-profile
9
- bun run boomkin chatgpt --action status --directory /absolute/path/to/boomkin-profile
10
- bun run boomkin chatgpt --action model --directory /absolute/path/to/boomkin-profile
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.
@@ -1,10 +1,14 @@
1
1
  # Boomkin connections
2
2
 
3
- Hermes owns authentication, tools and execution. Boomkin prepares an isolated profile and selected official connections; skill instructions do not create financial authority. Reviewed September 5, 2026; recheck current provider capabilities before granting access.
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
- `bun run boomkin onboard` runs the official pinned Hermes installer when needed and opens `hermes setup model` with the selected `HERMES_HOME`. Use `bun run boomkin model` to revisit setup, and `bun run boomkin start` for native chat. Model keys, OAuth and local models use Hermes's facilities. A configured model name or CLI version is not proof of authentication.
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
- `bun run 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:
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
- bun run boomkin connect --provider aixbt
47
- bun run boomkin doctor --live
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
- bun run boomkin connect --provider alchemy
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
- bun run boomkin connect --provider defillama
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
- bun run boomkin connect --provider coinbase
80
- bun run boomkin connect --provider coinbase --key-file /absolute/path/to/scoped-key.json
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
- bun run boomkin connect --provider tenderly
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 main onboarding product uses Hermes; start with the [getting-started guide](../README.md#get-started). The adapters below preserve portable skill installation in other harnesses and do not provision a complete Boomkin runtime there.
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
- bun run boomkin onboard --directory "$HOME/boomkin-hermes"
17
- bun run boomkin start --directory "$HOME/boomkin-hermes"
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
- bun run boomkin setup --harness hermes --directory "$HOME/your-hermes-profile"
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
- # From your Boomkin checkout:
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
- # From your Boomkin checkout (change the path if your workspace differs):
55
- bun run boomkin setup --harness openclaw --directory "$HOME/.openclaw/workspace"
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
- bun run boomkin setup --harness codex --directory "$HOME/boomkin-codex"
69
- bun run boomkin setup --harness claude --directory "$HOME/boomkin-claude"
70
- bun run boomkin setup --harness opencode --directory "$HOME/boomkin-opencode"
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 governance alongside LP and Hyperliquid. Portfolio reconciles holdings and performance; security investigates token risks and evidence changes, and reviews exact transaction effects and continuing authority. These are optional installed capabilities, not instructions to invoke every pack.
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 `bun run boomkin workflows` to discover the available protocol tasks and their required inputs. Existing profiles can adopt this routing deliberately; updates preserve custom instructions.
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