git404hub

what is miniclaude fr?

zmylol/miniclaude — explained in plain English

Analysis updated 2026-05-18

21PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

tl;dr

A lightweight, Claude Code style terminal AI coding assistant built as a local background daemon with tool calling, permissions, and MCP support.

vibe map

mindmap
  root((MiniClaude))
    What it is
      Claude Code style assistant
      Local background daemon
      Terminal based
    Clients
      mini CLI
      mini-tui interface
      JSON RPC over TCP
    Capabilities
      Tool calling
      Permission approvals
      MCP server support
    Tech stack
      Python
      uv package manager
      Anthropic API
    Extras
      Session memory
      Context compaction
      Trace and replay

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run a local terminal AI coding assistant that reads and edits files with your approval.

VIBE 2

Chat with an AI assistant through a full terminal UI that shows tool calls and streaming output live.

VIBE 3

Plug in external MCP tool servers to extend what the assistant can do.

VIBE 4

Replay and audit a past agent run from its saved trace and event logs.

what's the stack?

PythonuvAnthropic APIMCPTextual

how it stacks up fr

zmylol/miniclaude0whitedev/detranspiler2951461586/mulerun-pool
Stars212121
LanguagePythonPythonPython
Setup difficultymoderatehardmoderate
Complexity4/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Python 3.12, the uv package manager, and an Anthropic API key to run real chats or tasks.

MIT license: free to use, modify, and distribute for any purpose, including commercial use.

in plain english

MiniClaude is a lightweight terminal based AI coding assistant modeled after Claude Code. Instead of running as a single throwaway command line process, it is built as a local first system with a background daemon called mini-core that stays running and handles sessions, tool calls, events, permission approvals, and calls to the Anthropic API. Two separate clients, a plain command line tool called mini and a full terminal interface called mini-tui, talk to this daemon over a local network connection and let a person chat with the assistant or run one off tasks. Because the daemon and the clients are separate, other tools could in theory connect to the same daemon and watch or control what the assistant is doing, since everything happens through a documented JSON based protocol rather than being locked inside one process. The terminal interface shows the conversation, streaming responses, tool calls, and permission prompts in real time, and can even replay a past run from its saved event log. Built in tools let the assistant read and write files, run shell commands, manage simple tasks and notes, and delegate work to sub agents. Every tool call passes through a permission system, where a user can allow or deny a specific action either once or permanently, with the choices saved to a local policy file. The assistant also supports the Model Context Protocol, so external MCP tool servers can be plugged in and their tools become available to the assistant automatically. Other features mentioned include saving context and notes across turns, compacting long conversation history so it does not grow without bound, and a trace log that records internal events for debugging and replay. The project is written in Python, managed with the uv package manager, and requires Python 3.12 along with an Anthropic API key to actually run a chat or task. It is released under the MIT license.

prompts (copy fr)

prompt 1
Help me install uv and set up the MiniClaude environment on macOS or Linux.
prompt 2
Walk me through starting the mini-core daemon and connecting the TUI to it.
prompt 3
Explain how the permission approval system works for tool calls in this project.
prompt 4
Show me how to connect an external MCP server so its tools show up in mini-tui.

Frequently asked questions

what is miniclaude fr?

A lightweight, Claude Code style terminal AI coding assistant built as a local background daemon with tool calling, permissions, and MCP support.

What language is miniclaude written in?

Mainly Python. The stack also includes Python, uv, Anthropic API.

What license does miniclaude use?

MIT license: free to use, modify, and distribute for any purpose, including commercial use.

How hard is miniclaude to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is miniclaude for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.