# Technical Documentation: richards199999/Thinking-Claude

> ℹ️ **Provenance:** Multi-Tier Ingestion · [CodeWiki Reference](https://codewiki.google/github.com/richards199999/Thinking-Claude)

### Overview (`README.md`)

> [!CAUTION]
> **This repository has been retired.** Claude is already a reasoning model with strong built-in thinking capabilities, making this project no longer necessary. Thank you to everyone who contributed and supported Thinking Claude!

# Thinking Claude

Let Claude think comprehensively before responding!

> **A super quick reminder:**
> Thinking claude **is not aimed for benchmarks or huge leaps in math or something**, since those are pre-determined by the base model (new Claude-3.5 Sonnet).
> I only want to explore how further we could reach with Claude's "deep mindset". That said, when using it in your daily tasks, you will find Claude's inner monolog (thinking process) very very fun and interesting.

## Demo

> It is supposed to work on both `Free` and `Pro` versions of [Claude Web App](https://claude.ai/) with `Claude 3.5 Sonnet` model.

Here is a demo of using the latest [Thinking Cluade Chrome extension](https://github.com/richards199999/Thinking-Claude/releases/download/chrome-extension-v3.2.3/thinking-claude-chrome-extension-v3.2.3.zip) (click to download v3.2.3 ) installed in Chrome with the chat of Claude (check [Browser Extension](https://github.com/richards199999/Thinking-Claude?tab=readme-ov-file#browser-extension) for more) featured with an instruction selector:

https://github.com/user-attachments/assets/afa0f64f-53e5-45bc-9ad8-0641b29d2b77

use in project with legacy extension:

https://github.com/user-attachments/assets/88ff0c75-c51b-42b9-a042-00d47053795a

## Overview

This project consists of two main components:

1. **Thinking Protocol**: A comprehensive set of instructions that guides Claude to think deeply and systematically before responding
2. **Browser Extension**: A tool that makes Claude's thinking process more readable and manageable in the browser interface

## Project Structure

```bash
thinking-claude/
├── extensions/
│   ├── chrome/          # Current version of Chrome extension
│   ├── chrome_v0/       # Legacy Chrome extension (deprecated)
│   ├── firefox/         # Firefox extension (in development)
│   └── changelog.md
├── model_instructions/
│   ├── changelog.md
│   ├── v5.1-extensive-20241201.md
│   ├── v5.1-20241125.md
│   ├── v5-lite-20241124.md
│   ├── v4-20241118.md
│   ├── v4-lite-20241118.md
│   └── v3.5-20241113.md
├── .github/             # GitHub configurations and workflows
├── .husky/             # Git hooks for development
├── LICENSE
└── README.md
```

The project is organized into two main components:

- `extensions/`: Browser extension implementations

  - `chrome/`: Current version with modern architecture and features
  - `chrome_v0/`: Legacy version (deprecated)
  - `firefox/`: Firefox version (in development)

- `model_instructions/`: Thinking protocols for different versions
  - Contains versioned instruction sets
  - Each version brings improvements to Claude's thinking process

## Thinking Protocol

The thinking protocol instructs Claude to follow a natural, thorough thought process before providing responses.

## Browser Extension

The browser extension makes Claude's thinking process easier to read and use! It automatically organizes Claude's thoughts into neat, collapsible sections.

### Features

- 🎯 Makes Claude's thinking process easy to read
- 🔄 Fold and unfold different parts of Claude's thoughts
- 📋 Copy any part with just one click
- ⚡ Works automatically with new messages
- 🎨 Clean, modern design that's easy on the eyes

### 🚀 Quick Install Guide

1. **Chrome Users (May be Outdated)**

   - Install directly from the [Chrome Web Store](https://chromewebstore.google.com/detail/thinking-claude/ncjafpbbndpggfhfgjngkcimeaciahpo)

2. **Manual Installation（Recommended - latest v3.2.3）**
   - Download the latest version from our [Releases Page](https://github.com/richards199999/Thinking-Claude/releases)
   - Unzip the file
   - Open Chrome and go to `chrome://extensions/`
   - Turn on "Developer mode" (top right corner)
   - Click "Load unpacked" and select the unzipped folder `dist`

👉 Want more details? Check out our [Extension Guide](extensions/chrome/README.md) for:

- Step-by-step installation instructions
- Development setup
- Advanced features and usage
- Troubleshooting tips

### 🎉 Getting Started

Once installed, just:

1. Visit [Claude.ai](https://claude.ai)
2. Click on the `Choose style` selector in the bottom of input box -> click on `Create & Edit Styles` -> click on `Create Custom Style` -> click on `Describe style manually` -> click on `Start from scratch` -> click on `Use custom instructions (advanced)` -> paste the content of the desired instruction set from `model_instructions/` folder
3. Start chatting with Claude
4. That's it! The extension will automatically make Claude's thinking process more readable

## Why Use Thinking Claude?

- **Better Reasoning**: Get more thorough and well-thought-out responses
- **Transparency**: See how Claude arrives at its conclusions
- **Improved Organization**: Manage long conversations more effectively
- **Quality Control**: Benefit from built-in verification steps

## Contributing

Contributions are welcome! Feel free to:

- Submit bug reports
- Propose new features
- Create pull requests

## License

MIT License - feel free to use and modify as needed.

## Acknowledgments

Special thanks to [@lumpinif](https://github.com/lumpinif) and Claude for the extension!

---

### Overview (`extensions/chrome/README.md`)

# Thinking Claude Chrome Extension

A Chrome extension that enhances Claude's thinking process, making it more human-like and transparent.

> **Important Notice**: The original Chrome extension (`chrome_v0`) has been deprecated. This is the new rewritten version (`chrome`) with improved architecture and modern tech stack. If you're using the old version, please update to this new version for better performance and continued support.

## How to Use 🚀

### Option 1: Direct Installation (Recommended)

1. **Download the Extension**

   - Go to [Latest Releases](https://github.com/richards199999/Thinking-Claude/releases)
   - Download the latest version (e.g., `thinking-claude-v1.0.2.zip`)
   - Extract the ZIP file

2. **Install in Chrome**

   - Open Chrome and go to `chrome://extensions/`
   - Enable "Developer mode" in the top right
   - Click "Load unpacked"
   - Select the `dist` folder in the extracted folder

3. **Start Using**
   - Visit [Claude.ai](https://claude.ai)
   - Start a new conversation or refresh an existing one
   - The extension will automatically enhance Claude's thinking process

### Option 2: Build Locally (For Development)

1. **Quick Setup**

   ```bash
   # Clone the repository
   git clone https://github.com/richards199999/Thinking-Claude.git
   cd Thinking-Claude/extensions/chrome

   # Install dependencies
   bun install

   # Build the extension
   bun run build
   ```

2. **Load in Chrome**

   - Open Chrome and go to `chrome://extensions/`
   - Enable "Developer mode" in the top right
   - Click "Load unpacked"
   - Select the `dist` folder (created after building)

3. **Development Mode**

   ```bash
   # Start development server with hot reload
   bun run start

   # Watch for changes
   bun run watch
   ```

## Tech Stack 🛠️

### Core Technologies

- **Language & Type Safety**

  - [TypeScript](https://www.typescriptlang.org/) - Strongly typed programming language
  - [ESLint](https://eslint.org/) - Code linting and standards
  - [Prettier](https://prettier.io/) - Code formatting

- **Frontend**
  - [React](https://react.dev/) - UI library
  - [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS framework
  - [shadcn/ui](https://ui.shadcn.com/) - Best UI components
  - [Chrome Extension API](https://developer.chrome.com/docs/extensions/) - Browser extension development

### Development Tools

- **Build & Bundle**

  - [Bun](https://bun.sh) - JavaScript all-in-one toolkit
  - [Webpack](https://webpack.js.org/) - Module bundler
  - [PostCSS](https://postcss.org/) - CSS processing

- **Testing & Quality**

  - [Vitest](https://vitest.dev/) - Unit testing framework
  - [Husky](https://typicode.github.io/husky/) - Git hooks
  - [lint-staged](https://github.com/okonet/lint-staged) - Staged files linter

- **Development Environment**
  - [Node.js](https://nodejs.org/) - JavaScript runtime
  - [Chrome DevTools](https://developer.chrome.com/docs/devtools/) - Browser debugging

## Getting Started with development 🚀

### What You'll Need

Required tools:

- [Bun](https://bun.sh) - A fast all-in-one JavaScript runtime & toolkit
- [Node.js](https://nodejs.org/) (v18 or higher) - JavaScript runtime environment
- [Git](https://git-scm.com/downloads) - For version control
- [Google Chrome](https://www.google.com/chrome/) - The browser we're building for

This extension uses:

- [TypeScript](https://www.typescriptlang.org/) - Type-safe JavaScript
- [React](https://react.dev/) - UI framework
- [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS framework
- [Webpack](https://webpack.js.org/) - Module bundler

#### Installing Node.js

1. Download Node.js from [nodejs.org](https://nodejs.org/)
2. Choose the LTS (Long Term Support) version
3. Run the installer
4. Verify installation:

   ```bash
   node --version
   npm --version
   ```

#### Installing Bun

Bun is required to run this project. Here's how to install it:

**Windows Users:**

1. First, install Windows Subsystem for Linux (WSL):

   ```powershell
   # Open PowerShell as Administrator and run:
   wsl --install
   ```

   After installation, restart your computer.

2. Install Bun through WSL:

   ```bash
   # Open WSL terminal and run:
   curl -fsSL https://bun.sh/install | bash
   ```

**macOS or Linux Users:**

```bash
# Open terminal and run:
curl -fsSL https://bun.sh/install | bash
```

To verify installation, run:

```bash
bun --version
```

### Setting Up Your Development Environment

1. Get the code:

   ```bash
   # Clone this repository to your computer
   git clone https://github.com/richards199999/Thinking-Claude.git

   # Go to the extension directory
   cd extensions/chrome

   # Install project dependencies
   bun install
   ```

### Development Commands

Here are the main commands you'll use during development:

```bash
# Build the extension for production
bun run build

# Start development mode with auto-reload
bun run start

# Watch for file changes
bun run watch

# Run tests
bun run test

# Fix code style and formatting
bun run fix
```

### Installing the Extension in Chrome

1. Open Chrome and type `chrome://extensions/` in the address bar
2. Turn on "Developer mode" using the switch in the top right corner
3. Click "Load unpacked" and select the `dist (visible after running bun run build)` folder from this project

## Project Organization 📁

```
chrome/
├── src/             # Your source code goes here
├── public/            # Built extension (created after running build)
│   ├── manifest.json # Extension configuration
│   ├── content.js   # Main extension script
│   └── icons/       # Extension icons
├── package.json     # Project configuration and scripts
└── CHANGELOG.md     # Version history and changes
```

## Development Workflow 🔄

### Code Quality Tools

We use several tools to maintain code quality:

- **Husky**: Automatically checks your code before commits
- **ESLint**: Finds and fixes JavaScript problems
- **Prettier**: Formats your code consistently

### Version Control & Releases

The project uses automated version bumping through CI:

- **Automatic Version Bumping**: When code is merged to main, the CI will:

  - Auto-increment the patch version (e.g., 1.0.0 -> 1.0.1)
  - Create a new release with the bumped version
  - Skip version bump for major versions (x.0.0)

- **Manual Version Control**:
  - Developers can manually set both versions in `package.json` and `manifest.json`
  - Major version changes (x.0.0) must be set manually
  - Manual versions will be respected by CI

> **Note**: If you need to manually set a version, update both `package.json` and `manifest.json` before merging to main.

### Continuous Integration

Our GitHub Actions setup automatically:

- Builds the extension
- Updates version numbers
- Creates new releases

## Need Help? 🤔

- Check the [CHANGELOG.md](./CHANGELOG.md) for recent updates
- Visit our [GitHub Issues](https://github.com/richards199999/Thinking-Claude/issues) for known problems or to report new ones
- Feel free to ask questions in our GitHub Discussions

---

### Overview (`extensions/chrome_v0/README.md`)

# ⚠️ Deprecated: Thinking Claude Chrome Extension (v0)

> **Important**: This version of the Chrome extension (`chrome_v0`) has been deprecated and is no longer being maintained. Please use our new version for continued support and improvements.

## Migration Notice 🔄

### Why are we deprecating this version?

We've completely rewritten the extension with:

- Modern architecture and tech stack
- Improved performance
- Better maintainability
- Enhanced developer experience

### How to Update?

Please switch to our new version (`chrome`):

1. Uninstall this version (`chrome_v0`) from Chrome
2. Visit our [Latest Releases](https://github.com/richards199999/Thinking-Claude/releases) or refer to the [README.md](https://github.com/richards199999/Thinking-Claude/tree/main/extensions/chrome/README.md) in `extensions/chrome`
3. Download and install the new version

For installation instructions and documentation, see:

- [New Extension Documentation](https://github.com/richards199999/Thinking-Claude/tree/main/extensions/chrome/README.md)
- [Changelog](https://github.com/richards199999/Thinking-Claude/tree/main/extensions/chrome/CHANGELOG.md)

## Support

- This version will remain available for historical reference
- No new features or bug fixes will be added
- For any issues, please use the new version
- Report problems with the new version in our [GitHub Issues](https://github.com/richards199999/Thinking-Claude/issues)

---

Thank you for using Thinking Claude! We're committed to providing the best possible experience, which is why we've moved to a new, improved version.

---

--- METRICS ---
- Files Extracted: 3
- Estimated Token Budget: ~3545 tokens
- Canonical Reference: https://codewiki.google/github.com/richards199999/Thinking-Claude