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 | Presence | Description |
|---|---|---|
--profile <str> |
required | claudewheel profile to use |
--model <str> |
required | model to use, e.g. sonnet, haiku |
--permission-mode <str> |
required | one of default, acceptEdits, plan, bypassPermissions, dontAsk, auto |
--cwd <str> |
optional | working directory; omitted, the REPL runs in the current directory |
Which session the REPL runs is one selection over three named alternatives — pass exactly one, or none and get a new session:
| Flag | Effect |
|---|---|
--resume <session-id> |
resume that previous session |
--continue-session |
continue the most recent session |
--new-session |
start a fresh session (what you get by passing none of the three) |
Passing two of them is refused by name. 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.3.0.tar.gz.
File metadata
- Download URL: miniclaude-0.3.0.tar.gz
- Upload date:
- Size: 131.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
021ead3a243bb13aee94f20be96da2ecb5e5c35bfb224174302cf07e7c59458a
|
|
| MD5 |
0caad333eddda817a9f7297333072c58
|
|
| BLAKE2b-256 |
ad6720b472b242515e7207035e4ae017f05dd44c3c3bea20e6f65b4f8ef73dbb
|
Provenance
The following attestation bundles were made for miniclaude-0.3.0.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.3.0.tar.gz -
Subject digest:
021ead3a243bb13aee94f20be96da2ecb5e5c35bfb224174302cf07e7c59458a - Sigstore transparency entry: 2498579978
- Sigstore integration time:
-
Permalink:
smm-h/miniclaude@ab2182981a90667e92ca3568307f42dff8652f37 -
Branch / Tag:
refs/tags/v0.3.0 - Owner: https://github.com/smm-h
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@ab2182981a90667e92ca3568307f42dff8652f37 -
Trigger Event:
release
-
Statement type:
File details
Details for the file miniclaude-0.3.0-py3-none-any.whl.
File metadata
- Download URL: miniclaude-0.3.0-py3-none-any.whl
- Upload date:
- Size: 41.9 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 |
a9dbb783b5c69a6d67307249be4279dc3934d23fdefb5c0f620c4a4389ac62b5
|
|
| MD5 |
e2e7f70cca93b1e9862457acecd29f70
|
|
| BLAKE2b-256 |
c240b8bf13561783f114177bcd80be6e091ce2fc0978d562b643f98c574ab712
|
Provenance
The following attestation bundles were made for miniclaude-0.3.0-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.3.0-py3-none-any.whl -
Subject digest:
a9dbb783b5c69a6d67307249be4279dc3934d23fdefb5c0f620c4a4389ac62b5 - Sigstore transparency entry: 2498579980
- Sigstore integration time:
-
Permalink:
smm-h/miniclaude@ab2182981a90667e92ca3568307f42dff8652f37 -
Branch / Tag:
refs/tags/v0.3.0 - Owner: https://github.com/smm-h
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@ab2182981a90667e92ca3568307f42dff8652f37 -
Trigger Event:
release
-
Statement type:
