Mini Claude Code

A beautifully crafted Terminal User Interface for interacting with the Anthropic Claude Agent SDK, inspired by Claude Code.

Features

• 🚀 Fast & Efficient: Built with TypeScript and tsx.
• 🎨 Rich Aesthetics: Uses chalk, ora, and marked-terminal for a premium terminal experience.
• 🛠️ Tool Support: Integrated support for Anthropic Agent SDK tools (Bash, Edit, Read, etc.).
• 📦 Modern Structure: Modular code design following industry standards.

Project Structure

.
├── src/
│   ├── constants/       # Global constants (colors, config)
│   ├── core/            # Core logic (SDK interaction)
│   ├── utils/           # Utility functions (logger, renderer, prompts)
│   └── index.ts         # Application entry point
├── .env                 # Environment variables
├── tsconfig.json        # TypeScript configuration
└── package.json         # Project metadata and dependencies

Installation & Usage

1. Global Installation (Recommended)

Install the package globally via npm:

npm install -g @lewin671/mini-claude-code

After installation, you can start the application from anywhere using:

minicc

2. Run without Installation (npx)

If you just want to try it out without installing:

npx @lewin671/mini-claude-code

3. Local Development

If you'd like to run it from the source code:

1. Clone the repository and install dependencies:

   npm install

2. Run in development mode:

   npm run dev

Configuration

The application requires an Anthropic API key to function. You can provide this in two ways:

1. Using a .env file

Create a .env file in the project root:

ANTHROPIC_API_KEY=your_api_key_here
ANTHROPIC_BASE_URL=https://api.anthropic.com  # Optional

2. Using Shell Environment Variables

You can also set the variables directly in your terminal:

export ANTHROPIC_API_KEY=your_api_key_here
# Optional
export ANTHROPIC_BASE_URL=https://api.anthropic.com

Note on Priority: Shell environment variables take precedence over settings in the .env file.

License

ISC