infinite-craft-cli 1.4.0

Interactive CLI for Infinite Craft — combine elements from the terminal

infinite-craft-cli

Interactive CLI for Infinite Craft — combine elements from the terminal. Also available as a browser extension and web trainer.

Originally built on infinite-craft by @sqdnoises. As of v1.0, uses curl_cffi directly.

Installation

pip install infinite-craft-cli

Browser extension

Install the Infinite Craft Trainer from the Chrome Web Store — it loads automatically on neal.fun/infinite-craft. Works in Edge, Brave, and other Chromium browsers.

For other install methods (console snippet, userscript), see the web trainer page.

Usage

Interactive mode

infinite-craft

This opens a REPL where you can combine elements, search discoveries, and more:

craft> Water + Fire
  💨 Water + 🔥 Fire = 💨 Steam

craft> /search steam
  💨 Steam

craft> /help

Non-interactive mode

Most REPL commands are available as subcommands (shorthand operators like +, ++, +|, and * are REPL-only):

infinite-craft combine "Water" "Fire"
infinite-craft search "steam"
infinite-craft list
infinite-craft recipe "Steam"
infinite-craft import "Steam"
infinite-craft export
infinite-craft fill
infinite-craft unfilled
infinite-craft prune
infinite-craft exhaust "Water"
infinite-craft crawl "Water" "Fire"
infinite-craft permute "w*"
infinite-craft with "Water" "fire*"
infinite-craft cross "fire*" "water*"
infinite-craft --version

Commands

Combine & crawl

Shorthand	Slash command	Description
<element> + <element>	/combine <element> <element>	Combine two elements
<element> ++ <element>	/crawl <element> <element>	Combine & crawl until no new discoveries

Bulk combine

Shorthand	Slash command	Description
<element> then `+	then` (adjacent operator)	/with <element> <query>
<query> * <query>	/cross <query> <query>	Cross-combine matches from both queries
	/permute <query>	Combine all matching elements with each other
	/permutate <query>	Permute repeatedly until no new discoveries
	/exhaust <query>	Each match combined with all discoveries

Query syntax

Used by /search, /with, /permute, /permutate, /cross, /exhaust, and the +| / * shorthands:

Syntax	Meaning
substring	Case-insensitive substring (default)
* ? []	fnmatch wildcards (e.g. fire*, mu?)
/pattern/	Regex, case-insensitive (/pattern/; alternation | not supported)
!<query>	Exclude matches (e.g. !fire* = everything except fire*)
!	All elements (exclude nothing)
^<query>	First discoveries only (e.g. ^fire* = new fire* matches)
^	All first discoveries

Other commands

Command	Description
/search <query>	Search discoveries
/recipe <element>	Show shortest recipe from base elements
/list	List all discovered elements
/import <element|file.ic>	Import from Infinibrowser or .ic save file
/fill	Fetch missing recipes from Infinibrowser
/unfilled	List elements without recipes
/prune	Remove orphan elements Infinibrowser can't fill
/export [path]	Export discoveries as .ic save file
/history	Show combinations tried this session
/queue	Show running and pending commands (status also appears above craft>)
/help	Show help
/quit	Exit

Background queue (Python REPL)

Long-running API commands queue FIFO. Local commands (/help, /search, /list, /recipe, /history, /clear, /unfilled, /queue) run immediately — output from a local command may interleave with a running queued command (e.g. /search during /crawl).

Key	Action
Esc	Skip current command, continue to next in queue (TTY only)
Ctrl+C	While running: stop and discard remaining queue; at bulk confirm [y/N]: decline only

Deferred commands print Queued: when another command is already running.

Data storage

Discoveries and recipes are stored in ~/.infinite-craft-cli/:

• discoveries.json -- all discovered elements
• recipes.json -- known element combinations
• export.ic -- default export location

Browser extension / bookmarklet

The browser trainers share the same command syntax and query matching as the Python CLI (wildcards, /regex/, ! exclude, ^ first discoveries, /combine, /with, /cross, and operator shorthands +, ++, +|, *). Browser-only additions: /clear to clear the output panel, and IndexedDB storage instead of ~/.infinite-craft-cli/. Queue status is shown in the panel above the input (visual-only; no /queue command). Local commands such as /search may interleave output with a running queued command.

Development

Run unit tests:

bazel test //tests/...

Run integration tests (hits the real API):

bazel test //tests:test_integration --test_env=INTEGRATION_TESTS=1

License

MIT