infinite-craft-cli 1.3.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 <el> + <el>	Combine two elements (/combine <el> <el> also works)
<element> ++ <element>	/crawl <el> + <el>	Combine & crawl until no new discoveries (/crawl <el> <el> also works)

Bulk combine

Shorthand	Slash command	Description
<element> + | <query>	/with <element> <query>	Combine element with all matching discoveries (+ | spaced variant also works)
<query> * <query>	/cross <query> * <query>	Cross-combine matches from both queries (/cross <q> <q> also works for simple queries)
	/permute <query>	Combine all matching elements with each other
	/exhaust <element>	Combine element with all discoveries

Query syntax

Used by /search, /with, /permute, /cross, 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>	First discoveries only (e.g. !fire*)
^<query>	Legacy alias for !<query>

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
/help	Show help
/quit	Exit

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/, !/^ first-discovery filters, /combine, /with, /cross, and spaced operator delimiters). Browser-only additions: /clear to clear the terminal output, and IndexedDB storage instead of ~/.infinite-craft-cli/.

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