miniclaude
A lean, snappy fullscreen terminal client for Claude Code sessions — a minimal alternative frontend to the official TUI. It drives the official claude CLI through the claudestream library, so tools, permissions, sessions, and authentication are all the real thing; miniclaude only replaces the presentation layer.
Design stance
- Fullscreen, block-backed rendering. Output is modelled as blocks and materialized into a scrollable output region on the alternate screen. Scroll with the mouse wheel; the view holds where you leave it (scroll-lock) and re-flows tables to the live terminal width on resize.
- Line-grain streaming markdown. Assistant prose is styled and emitted line by line as it arrives (headers, bullets, inline code, links, code fences). Tables are the one buffered exception, held until complete and printed with aligned columns.
- Dense tool activity. Each tool call is one line (
▸ ToolName arg); each result is one dim line (✓/✗plus a(+N lines)count). Subagent activity is indented. - Interactive tools that work in the terminal. Permission prompts show a real decision surface (the Bash command, a colored diff for edits, a preview for writes) above numbered Allow/Deny choices. AskUserQuestion is answered through plain numbered prompts (single- and multi-select).
- Type-ahead with interrupt. Type while a turn runs and the line is queued; press Esc to interrupt the in-flight turn.
Requirements
- Python >= 3.11
- The
claudeCLI installed and logged in - A claudewheel profile
Install
uv tool install miniclaude
pip install miniclaude
npm i -g miniclaude
The npm package is a Node shim that runs the installed Python miniclaude; install the Python package as well.
Usage
miniclaude repl --profile <name> --model <model> --permission-mode <mode>
Example:
miniclaude repl --profile default --model sonnet --permission-mode default
| Flag | Required | Description |
|---|---|---|
--profile <str> |
yes | claudewheel profile to use |
--model <str> |
yes | model to use, e.g. sonnet, haiku |
--permission-mode <str> |
yes | one of default, acceptEdits, plan, bypassPermissions, dontAsk, auto |
--cwd <str> |
no | working directory (default: current) |
--resume <str> |
no | resume a previous session by ID |
--continue-session / --no-continue-session |
no | continue the most recent session (default: off) |
--resume and --continue-session are mutually exclusive. Run miniclaude version to print the version.
In-session
Slash commands:
| Command | Effect |
|---|---|
/model <name> |
switch model (no argument: show current) |
/mode <mode> |
change permission mode (no argument: show current) |
/context |
show context-window usage |
/cost |
show session cost and token totals |
/help |
list the slash commands |
/quit, /exit |
leave the REPL |
Unknown / commands are sent to the session verbatim, so server-side commands still work.
Keybindings:
| Key | Action |
|---|---|
| Enter | submit the prompt |
| Alt+Enter | insert a newline |
| Esc | interrupt the running turn |
| Ctrl+C | clear the input when idle; interrupt the running turn |
| Ctrl+D | exit (on an empty input) |
claudewheel integration
Launch it from claudewheel with claudewheel --client miniclaude.
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 Distribution
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 miniclaude-0.2.1.tar.gz.
File metadata
- Download URL: miniclaude-0.2.1.tar.gz
- Upload date:
- Size: 125.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b79abc380421c1dd7b65b2069c5831cd6f287f11c24e91a10b1627ea2fc6c1bf
|
|
| MD5 |
a2ea1c021dda77c8dbdc0d0718d95a38
|
|
| BLAKE2b-256 |
41f7fde0d9725e12a567e59db5916bf7a6431187c42f39025af7ced0febd8a11
|
Provenance
The following attestation bundles were made for miniclaude-0.2.1.tar.gz:
Publisher:
publish.yml on smm-h/miniclaude
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
miniclaude-0.2.1.tar.gz -
Subject digest:
b79abc380421c1dd7b65b2069c5831cd6f287f11c24e91a10b1627ea2fc6c1bf - Sigstore transparency entry: 2348286513
- Sigstore integration time:
-
Permalink:
smm-h/miniclaude@8ee867e2be856794d47da1206b74620f7e4d992b -
Branch / Tag:
refs/tags/v0.2.1 - Owner: https://github.com/smm-h
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8ee867e2be856794d47da1206b74620f7e4d992b -
Trigger Event:
release
-
Statement type:
File details
Details for the file miniclaude-0.2.1-py3-none-any.whl.
File metadata
- Download URL: miniclaude-0.2.1-py3-none-any.whl
- Upload date:
- Size: 41.3 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 |
1b99dd930b98dd949aa2f0e6df2522067388c9abe43286d3d67d4d7decdb58f0
|
|
| MD5 |
5d7a5618183e556a1f1666f41e906cc2
|
|
| BLAKE2b-256 |
535bf7af98cbd2439a36960c82e5c4ddc376817d3154370fa6be127f58234cb7
|
Provenance
The following attestation bundles were made for miniclaude-0.2.1-py3-none-any.whl:
Publisher:
publish.yml on smm-h/miniclaude
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
miniclaude-0.2.1-py3-none-any.whl -
Subject digest:
1b99dd930b98dd949aa2f0e6df2522067388c9abe43286d3d67d4d7decdb58f0 - Sigstore transparency entry: 2348286575
- Sigstore integration time:
-
Permalink:
smm-h/miniclaude@8ee867e2be856794d47da1206b74620f7e4d992b -
Branch / Tag:
refs/tags/v0.2.1 - Owner: https://github.com/smm-h
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8ee867e2be856794d47da1206b74620f7e4d992b -
Trigger Event:
release
-
Statement type:
