Thinking-Claude Documentation

Let your Claude able to think

17,020 stars TypeScript TypeScript 1 file Β· ~3,634 tokens
RAW Doc

Technical Documentation: richards199999/Thinking-Claude

ℹ️ Provenance: Multi-Tier Ingestion Β· CodeWiki Reference

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 with Claude 3.5 Sonnet model.

Here is a demo of using the latest Thinking Cluade Chrome extension (click to download v3.2.3 ) installed in Chrome with the chat of Claude (check 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)

  2. Manual Installation(Recommended - latest v3.2.3οΌ‰

    • Download the latest version from our Releases Page
    • 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 for:

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

πŸŽ‰ Getting Started

Once installed, just:

  1. Visit 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 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 πŸš€

  1. Download the Extension

    • Go to Latest 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
    • 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

Development Tools

Getting Started with development πŸš€

What You'll Need

Required tools:

  • Bun - A fast all-in-one JavaScript runtime & toolkit
  • Node.js (v18 or higher) - JavaScript runtime environment
  • Git - For version control
  • Google Chrome - The browser we're building for

This extension uses:

Installing Node.js

  1. Download Node.js from 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 πŸ“

text
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 for recent updates
  • Visit our GitHub 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 or refer to the README.md in extensions/chrome
  3. Download and install the new version

For installation instructions and documentation, see:

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

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 ---