Portlight Trade. Sail. Build a career.

TUI and CLI

Full play in the Textual TUI: harbor, contracts, infra, shipyard, fleet, campaign. CLI for scripts and --json. Same save file.

Living economy

20 ports, 18 goods, 43 routes across 5 regions. Dump grain and the price crashes. Every port has a real import/export identity.

Nine captains

Merchant through Bounty Hunter. Each starts in a different port, sees different contracts, and leans toward a different victory path.

Infrastructure that matters

Warehouses, brokers in all five regions, seven licenses. Upkeep is real. W twice in the TUI to lease, deposit, or open an office.

Combat with consequences

Stance triangle, naval flee/capture, prize hulls you can actually board. Bounty hunt spawns the named captain you accepted.

1,853 tests

14 cross-system invariants, 9 compound stress scenarios, 7-bot balance harness. Save format v12 with a full migration chain.

Install

pip install "portlight[tui]"
# or: npx @mcptoolshop/portlight

TUI

portlight tui
# New game if no save. H harbor, K contracts, W infra.

CLI trade

portlight new "Captain Hawk" --type merchant
portlight buy grain 10
portlight sail al_manar
portlight advance
portlight sell grain 10

Career

portlight map
portlight milestones
portlight bounty accept scarlet_ana
portlight bounty hunt scarlet_ana