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
FreeandProversions of Claude Web App withClaude 3.5 Sonnetmodel.
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:
- Thinking Protocol: A comprehensive set of instructions that guides Claude to think deeply and systematically before responding
- Browser Extension: A tool that makes Claude's thinking process more readable and manageable in the browser interface
Project Structure
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.mdThe project is organized into two main components:
extensions/: Browser extension implementationschrome/: Current version with modern architecture and featureschrome_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
Chrome Users (May be Outdated)
- Install directly from the Chrome Web Store
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:
- Visit Claude.ai
- Click on the
Choose styleselector in the bottom of input box -> click onCreate & Edit Styles-> click onCreate Custom Style-> click onDescribe style manually-> click onStart from scratch-> click onUse custom instructions (advanced)-> paste the content of the desired instruction set frommodel_instructions/folder - Start chatting with Claude
- 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 π
Option 1: Direct Installation (Recommended)
Download the Extension
- Go to Latest Releases
- Download the latest version (e.g.,
thinking-claude-v1.0.2.zip) - Extract the ZIP file
Install in Chrome
- Open Chrome and go to
chrome://extensions/ - Enable "Developer mode" in the top right
- Click "Load unpacked"
- Select the
distfolder in the extracted folder
- Open Chrome and go to
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)
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 buildLoad in Chrome
- Open Chrome and go to
chrome://extensions/ - Enable "Developer mode" in the top right
- Click "Load unpacked"
- Select the
distfolder (created after building)
- Open Chrome and go to
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 - Strongly typed programming language
- ESLint - Code linting and standards
- Prettier - Code formatting
Frontend
- React - UI library
- Tailwind CSS - Utility-first CSS framework
- shadcn/ui - Best UI components
- Chrome Extension API - Browser extension development
Development Tools
Build & Bundle
Testing & Quality
- Vitest - Unit testing framework
- Husky - Git hooks
- lint-staged - Staged files linter
Development Environment
- Node.js - JavaScript runtime
- Chrome DevTools - Browser debugging
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:
- TypeScript - Type-safe JavaScript
- React - UI framework
- Tailwind CSS - Utility-first CSS framework
- Webpack - Module bundler
Installing Node.js
Download Node.js from nodejs.org
Choose the LTS (Long Term Support) version
Run the installer
Verify installation:
bashnode --version npm --version
Installing Bun
Bun is required to run this project. Here's how to install it:
Windows Users:
First, install Windows Subsystem for Linux (WSL):
powershell# Open PowerShell as Administrator and run: wsl --installAfter installation, restart your computer.
Install Bun through WSL:
bash# Open WSL terminal and run: curl -fsSL https://bun.sh/install | bash
macOS or Linux Users:
# Open terminal and run:
curl -fsSL https://bun.sh/install | bashTo verify installation, run:
bun --versionSetting Up Your Development Environment
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:
# 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 fixInstalling the Extension in Chrome
- Open Chrome and type
chrome://extensions/in the address bar - Turn on "Developer mode" using the switch in the top right corner
- 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 changesDevelopment 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.jsonandmanifest.json - Major version changes (x.0.0) must be set manually
- Manual versions will be respected by CI
- Developers can manually set both versions in
Note: If you need to manually set a version, update both
package.jsonandmanifest.jsonbefore 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):
- Uninstall this version (
chrome_v0) from Chrome - Visit our Latest Releases or refer to the README.md in
extensions/chrome - 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 ---
- Files Extracted: 3
- Estimated Token Budget: ~3545 tokens
- Canonical Reference: https://codewiki.google/github.com/richards199999/Thinking-Claude