kalshi-trading-bot-cli 2.1.1 → 2.1.3

package/README.md

@@ -8,12 +8,20 @@ Integrates with the [Octagon Research API](https://app.octagonai.co) for AI-gene
 
 ![Kalshi Trading Bot CLI](assets/screenshot.png)
 
-## Quick Start
+## Prerequisites
+
+- **[Bun](https://bun.com/) ≥ 1.1** (required — the bot uses `bun:sqlite` and runs `.tsx` directly; Node.js won't work)
+  ```bash
+  curl -fsSL https://bun.com/install | bash
+  ```
+- A **Kalshi** account with API access (API key + RSA private key)
+- One **LLM provider key** (OpenAI / Anthropic / Google / xAI / OpenRouter / Ollama). The setup wizard collects these on first run.
+- Optional: an **[Octagon](https://app.octagonai.co)** key for AI edge analysis, and a **Tavily** key for web research.
 
-Install [Bun](https://bun.com/), then run:
+## Quick Start
 
 ```bash
-bunx kalshi-trading-bot-cli
+bunx kalshi-trading-bot-cli@latest
 ```
 
 That's it — no clone, no install. The setup wizard runs automatically on first launch and walks you through API keys.
@@ -29,18 +37,36 @@ bun install
 bun start
 ```
 
-> Don't have Bun? Install it with `curl -fsSL https://bun.com/install | bash`
-
 ### Where things live
 
 - **Config, cache, SQLite DB:** `~/.kalshi-bot/`
 - **API keys (`.env`):** `~/.kalshi-bot/.env` — written by the setup wizard. A `.env` in the current directory takes precedence (handy for dev).
 - **First run** with no keys configured triggers the setup wizard automatically.
 
-## Example Session
+### Updating
 
+Using `@latest` in the `bunx` command always pulls the newest published version — so `bunx kalshi-trading-bot-cli@latest` is the zero-friction path.
+
+If you ran `bunx kalshi-trading-bot-cli` without `@latest`, Bun may serve a cached copy. Force a refresh:
+
+```bash
+bunx kalshi-trading-bot-cli@latest   # pin latest for this invocation
+bun pm cache rm                      # or clear Bun's install cache
 ```
-$ bunx kalshi-trading-bot-cli
+
+If you installed globally with `bun add -g kalshi-trading-bot-cli`:
+
+```bash
+bun update -g kalshi-trading-bot-cli         # update in place
+bun add -g kalshi-trading-bot-cli@latest     # or reinstall pinned to latest
+```
+
+Check your installed version with `kalshi --version` (or `bun pm ls -g | grep kalshi`).
+
+## Example Session
+
+```text
+$ bunx kalshi-trading-bot-cli@latest
 
 Welcome to Kalshi Trading Bot CLI
 Type help for commands, or just ask a question.
@@ -338,7 +364,7 @@ TELEMETRY_ENABLED=false
 Or set the environment variable before running:
 
 ```bash
-TELEMETRY_ENABLED=false bunx kalshi-trading-bot-cli
+TELEMETRY_ENABLED=false bunx kalshi-trading-bot-cli@latest
 ```
 
 ## Documentation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kalshi-trading-bot-cli",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "Kalshi Trading Bot CLI - AI-powered prediction market terminal.",
   "license": "MIT",
   "author": "Octagon AI, Inc.",

package/src/cli.ts

@@ -922,7 +922,7 @@ export async function runCli(options?: { forceSetup?: boolean }) {
     editor.addToHistory(msg);
   }
 
-  // Auto-launch setup wizard if credentials are missing or `bun start init` was used
+  // Auto-launch setup wizard if credentials are missing or `kalshi init` was used
   if (!hasKalshiCreds || options?.forceSetup) {
     setupWizard.start();
   }

package/src/commands/help.ts

@@ -109,12 +109,12 @@ from the snapshot when available, else current Kalshi lifetime volume.
 ROI is capital-weighted: sum(pnl) / sum(capital) across edge signals, where capital
 is kp/100 for YES edges and (100-kp)/100 for NO edges (matches Supabase methodology).`,
 
-    'clear-cache': `**${ctx === 'cli' ? '' : 'bun start '}clear-cache** — Delete local cache
+    'clear-cache': `**${ctx === 'cli' ? '' : 'kalshi '}clear-cache** — Delete local cache
 
-${ctx === 'cli' ? `${p}` : 'bun start '}clear-cache                Delete the local SQLite database (~/.kalshi-bot/kalshi-bot.db)
+${ctx === 'cli' ? `${p}` : 'kalshi '}clear-cache                Delete the local SQLite database (~/.kalshi-bot/kalshi-bot.db)
                                A fresh database will be created on next command.
 
-Use this when the local cache is corrupted or you want to start fresh.${ctx !== 'cli' ? '\nRun from terminal: bun start clear-cache' : ''}`,
+Use this when the local cache is corrupted or you want to start fresh.${ctx !== 'cli' ? '\nRun from terminal: kalshi clear-cache' : ''}`,
 
     init: `**${p}init** — Re-run setup wizard
 
@@ -211,8 +211,8 @@ Account:
 System:
   /model                         Change LLM model/provider
   /setup                         Re-run setup wizard
-  init                           Launch with setup wizard (run: bun start init)
-  clear-cache                    Delete local cache (run: bun start clear-cache)
+  init                           Launch with setup wizard (run: kalshi init)
+  clear-cache                    Delete local cache (run: kalshi clear-cache)
   /help [command]                Show help for a command
   /quit                          Quit
 

package/src/commands/status.ts

@@ -1,6 +1,6 @@
 import { callKalshiApi } from '../tools/kalshi/api.js';
-import { PROVIDERS } from '@/providers';
-import { getDefaultModelForProvider } from '@/utils/model';
+import { PROVIDERS } from '../providers.js';
+import { getDefaultModelForProvider } from '../utils/model.js';
 
 /**
  * Verify setup: check API keys, exchange connectivity, and optional services.

package/src/model/llm.ts

@@ -9,11 +9,11 @@ import { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import { StructuredToolInterface } from '@langchain/core/tools';
 import { Runnable } from '@langchain/core/runnables';
 import { z } from 'zod';
-import { DEFAULT_SYSTEM_PROMPT } from '@/agent/prompts';
-import type { TokenUsage } from '@/agent/types';
-import { logger } from '@/utils';
-import { classifyError, isNonRetryableError } from '@/utils/errors';
-import { resolveProvider, getProviderById } from '@/providers';
+import { DEFAULT_SYSTEM_PROMPT } from '../agent/prompts.js';
+import type { TokenUsage } from '../agent/types.js';
+import { logger } from '../utils/index.js';
+import { classifyError, isNonRetryableError } from '../utils/errors.js';
+import { resolveProvider, getProviderById } from '../providers.js';
 
 export const DEFAULT_PROVIDER = 'openai';
 export const DEFAULT_MODEL = process.env.DEFAULT_MODEL ?? 'gpt-5.4';

package/src/setup/wizard.ts

@@ -202,13 +202,13 @@ export class SetupWizardController {
       if (this.configWritten) {
         lines.push('');
         lines.push(theme.muted('  Default thresholds (to customize, run the command shown):'));
-        lines.push(`    min_edge_threshold  = 5%     ${theme.muted('e.g. bun start config risk.min_edge_threshold 0.10')}`);
-        lines.push(`    kelly_multiplier    = 0.5    ${theme.muted('e.g. bun start config risk.kelly_multiplier 0.25')}`);
-        lines.push(`    max_position_pct    = 10%    ${theme.muted('e.g. bun start config risk.max_position_pct 0.05')}`);
-        lines.push(`    daily_loss_limit    = $200   ${theme.muted('e.g. bun start config risk.daily_loss_limit 100')}`);
-        lines.push(`    max_positions       = 10     ${theme.muted('e.g. bun start config risk.max_positions 5')}`);
+        lines.push(`    min_edge_threshold  = 5%     ${theme.muted('e.g. kalshi config risk.min_edge_threshold 0.10')}`);
+        lines.push(`    kelly_multiplier    = 0.5    ${theme.muted('e.g. kalshi config risk.kelly_multiplier 0.25')}`);
+        lines.push(`    max_position_pct    = 10%    ${theme.muted('e.g. kalshi config risk.max_position_pct 0.05')}`);
+        lines.push(`    daily_loss_limit    = $200   ${theme.muted('e.g. kalshi config risk.daily_loss_limit 100')}`);
+        lines.push(`    max_positions       = 10     ${theme.muted('e.g. kalshi config risk.max_positions 5')}`);
         lines.push('');
-        lines.push(theme.muted('  Run "bun start config" to see all settings.'));
+        lines.push(theme.muted('  Run "kalshi config" to see all settings.'));
       }
       return lines;
     }

package/src/utils/env.ts

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
 import { resolve } from 'path';
 import { config } from 'dotenv';
-import { getProviderById } from '@/providers';
+import { getProviderById } from '../providers.js';
 import { appPath, getAppDir } from './paths.js';
 
 // Resolve .env from a CWD override (dev workflow) or the home config dir

package/src/utils/model.ts

@@ -1,4 +1,4 @@
-import { PROVIDERS as PROVIDER_DEFS } from '@/providers';
+import { PROVIDERS as PROVIDER_DEFS } from '../providers.js';
 
 export interface Model {
   id: string;