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
Metadata
1 maintainer
Release files for miniclaude 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| miniclaude-0.3.0.tar.gz | 131.4 kB | With provenance | Details for miniclaude-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| miniclaude-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for miniclaude-0.3.0-py3-none-any.whl |
Total release size: 173.3 kB
Release files / miniclaude-0.3.0.tar.gz
| Download URL | miniclaude-0.3.0.tar.gz |
|---|---|
| Size | 131.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
021ead3a243bb13aee94f20be96da2ecb5e5c35bfb224174302cf07e7c59458a
|
|
BLAKE2b-256 checksum How to use checksums |
ad6720b472b242515e7207035e4ae017f05dd44c3c3bea20e6f65b4f8ef73dbb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency logRelease files / miniclaude-0.3.0-py3-none-any.whl
| Download URL | miniclaude-0.3.0-py3-none-any.whl |
|---|---|
| Size | 41.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a9dbb783b5c69a6d67307249be4279dc3934d23fdefb5c0f620c4a4389ac62b5
|
|
BLAKE2b-256 checksum How to use checksums |
c240b8bf13561783f114177bcd80be6e091ce2fc0978d562b643f98c574ab712
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency logSecurity for miniclaude 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for miniclaude-0.3.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
