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 and fetches the current trainer (trainer.min.js) from GitHub Pages with cache: 'no-store', so feature updates ship without waiting for a Chrome Web Store release. The extension manifest version (extension/manifest.json) is independent of the Python CLI package version (git tags). See PRIVACY.md for the remote-script trust model. Works in Edge, Brave, and other Chromium browsers.
Manual QA (extension): After changes to extension/loader.js, load the unpacked extension on live neal.fun/infinite-craft and confirm the trainer UI appears and IndexedDB-backed commands work (e.g. /list).
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 elementsrecipes.json-- known element combinationsexport.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
After editing bookmarklet/trainer.src.mjs, rebuild the bundles:
bazel build //bookmarklet:site
Build the Python wheel:
bazel build //release:wheel.dist
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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file infinite_craft_cli-1.8.4-py3-none-any.whl.
File metadata
- Download URL: infinite_craft_cli-1.8.4-py3-none-any.whl
- Upload date:
- Size: 63.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
44596e9d3a20587ef8ce65c82416b555ed9540f9822e1444de1013070b5069af
|
|
| MD5 |
c53b3959564acb4535eb0a7bc295591d
|
|
| BLAKE2b-256 |
d574f0c0927434cfc85bce4486de3f72f729ca2b0ed2ad478d97fac636df0463
|
Provenance
The following attestation bundles were made for infinite_craft_cli-1.8.4-py3-none-any.whl:
Publisher:
publish.yml on hacker6284/infinite-craft-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
infinite_craft_cli-1.8.4-py3-none-any.whl -
Subject digest:
44596e9d3a20587ef8ce65c82416b555ed9540f9822e1444de1013070b5069af - Sigstore transparency entry: 2374080260
- Sigstore integration time:
-
Permalink:
hacker6284/infinite-craft-cli@8004b94a7d6d12daac49e7927bfd18004992c98f -
Branch / Tag:
refs/tags/v1.8.4 - Owner: https://github.com/hacker6284
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8004b94a7d6d12daac49e7927bfd18004992c98f -
Trigger Event:
push
-
Statement type:
