borski /travel-hacking-toolkit

AI-powered travel hacking and search with cash, points, miles, and award flights. Drop-in skills and MCP servers for Claude, Codex, and OpenCode.

★ 992⑂ 124👁 7⑃ 39● 8▤ 0
PythonMITCreated 2026-03-21
992
stars
124
forks
7
watchers
39
prs
8
issues
0
releases

README

Travel Hacking Toolkit

AI-powered travel hacking with points, miles, and award flights. Drop-in skills and MCP servers for OpenCode, Claude Code, and Codex.

Ask your AI to find you a 60,000-mile business class flight to Tokyo. It'll search award availability across 27 mileage programs, compare against cash prices, check your loyalty balances, and tell you the best play.

 Quick Start

 Install via plugin (no clone)

The easiest way to use the toolkit. Pick your tool:

 Claude Code

Inside Claude Code, run:


/plugin marketplace add borski/travel-hacking-toolkit
/plugin install travel-hacker@borski


Done. 42 skills, 7 MCP servers (6 free + LiteAPI which needs a key), and the travel-hacker subagent are installed. Run claude from anywhere and ask it to plan a trip.

To verify the install, run /travel-hacker:getting-started inside Claude Code. It tells you which API keys are configured and points at the local setup script for the missing ones. Or in your shell: claude plugin list | grep travel-hacker should show the plugin.

 Codex

In your terminal:

bash
codex plugin marketplace add borski/travel-hacking-toolkit


Then start Codex and the plugin appears in /plugins. Codex pulls the marketplace catalog from the repo (.agents/plugins/marketplace.json) and the plugin manifest from plugins/travel-hacking-toolkit/.codex-plugin/plugin.json, so the install is one command.

 Cowork (Claude Desktop's agent panel)

Cowork itself doesn't expose /plugin slash commands, so you can't install plugins from inside a Cowork chat. Install via Claude Code first; Cowork picks it up automatically because both share ~/.claude/plugins/.

1. In your terminal, run claude
2. In Claude Code, run the two install commands from the Claude Code section above
3. Open Cowork inside Claude Desktop. The plugin is already there.

Claude Desktop's chat UI doesn't support the plugin format yet, so use Cowork inside the same app for the full experience.

 Configure API keys

The 6 free MCP servers (Skiplagged, Kiwi, Trivago, Ferryhopper, Airbnb, Seats.aero) work immediately with zero keys. Cash flight and hotel search work out of the box, and so does cached award search for flights in the next 60 days.

To unlock award search and the rest of the toolkit, you need API keys set as environment variables in your shell. Run the local setup script:

macOS / Linux / WSL / Git Bash:

bash
bash  The toolkit reads keys from the shell environment because plugin userConfig doesn't propagate to skills that shell out to scripts (verified empirically; related upstream issues anthropics/claude-code11927, 39125).

 Clone path (for OpenCode users or contributors)

OpenCode doesn't have a plugin format, so OpenCode users clone the repo. Contributors who want to hack on the toolkit also clone.

bash
git clone https://github.com/borski/travel-hacking-toolkit.git
cd travel-hacking-toolkit

 macOS / Linux / WSL / Git Bash
./scripts/setup.sh

 Windows (PowerShell or cmd)
.\scripts\setup.cmd


The setup scrip

Top issues

Snapshot: 2026-11-16T23:08:42Z · Data license Apache-2.0 · JSON