# claude-nexus

**Repository Path**: Qiuner/claude-nexus

## Basic Information

- **Project Name**: claude-nexus
- **Description**: An all-in-one enhancement suite for Claude.ai - folder management, timeline navigation, and chat export in one powerful extension.
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-10
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
<img src="public/icon-128.png" width="96" alt="claude-nexus logo" />

# claude-nexus

### The missing power-up for Claude ✨

Supercharge your [claude.ai](https://claude.ai) experience with folder organization, timeline navigation, prompt library, and more.

[![Chrome](https://img.shields.io/badge/Chrome-✓-4285F4?style=flat-square&logo=googlechrome&logoColor=white)](#installation)
[![License: MIT](https://img.shields.io/badge/License-MIT-D97757?style=flat-square)](LICENSE)
[![Built with React](https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=black)](https://react.dev)
[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org)

[English](#) · [中文](.github/README_ZH.md)

</div>

---

> I use Claude every day. But as conversations pile up, the sidebar becomes a mess — no way to group them, no way to find what you need.
>
> One day I came across [gemini-voyager](https://github.com/Nagi-ovo/gemini-voyager) and was genuinely impressed by the idea. I thought: why doesn't Claude have something like this?
>
> So I built it.

## ✨ Features

### 📂 Folder Organization

**Keep your conversations sorted.**
Drag and drop your chats into folders that make sense to you. Stop digging through a cluttered history list.

- **Drag & drop**: Move conversations into folders effortlessly
- **Easy management**: Rename, delete, and reorganize at any time
- **Persistent storage**: Your folder structure is saved locally across sessions

![New folder](docs/assets/NewFolder.gif)

### 📍 Timeline Navigation

**Never get lost in a long conversation again.**
Visual nodes let you see the structure of your chat at a glance and jump to any message instantly. Fixed on the right; click to jump and hover to preview messages.

![Timeline](docs/assets/TimeLine.gif)

### 🫧 Floating Ball + 📐 Chat Width Control

**Quick access utilities.**
Drag the floating ball anywhere and open panels for common actions, including chat width control (38–90rem, default 48rem).

![FloatBall](docs/assets/FloatBall.png)
![Chat width](docs/assets/DialogueWidth.gif)

### 💡 Prompt Library

**Your personal prompt arsenal.**
Save, search, edit, and insert prompts directly into the chat input toolbar.

![PromptLibrary](docs/assets/PromptLibrary.png)
![PromptLibrary](docs/assets/PromptLibrary.gif)

### 💾 Chat Export

**Your data, your format.**
Export conversations as Markdown or JSON from the toolbar.

![ChatExport](docs/assets/ChatExport.png)
![ChatExport](docs/assets/DownloadChatHistory.gif)

---

## 📥 Installation

### Manual Installation (Development)

1. Clone the repository

   ```bash
   git clone https://github.com/your-username/claude-nexus.git
   cd claude-nexus
   ```

2. Install dependencies

   ```bash
   yarn install
   ```

3. Build the extension

   ```bash
   yarn build:chrome
   ```

4. Load in Chrome
   - Open `chrome://extensions`
   - Enable **Developer mode**
   - Click **Load unpacked**
   - Select the `dist/` folder

---

## 🛠️ Development

```bash
# Start development mode with auto-rebuild
yarn dev:chrome

# After each build:
# 1. Open chrome://extensions
# 2. Click the refresh button on claude-nexus
# 3. Refresh the claude.ai page
```

### Tech Stack

- **Framework**: React 19 + TypeScript
- **Styling**: TailwindCSS 4
- **Build**: Vite + vite-web-extension
- **Platform**: Chrome Manifest V3

---

## 🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

1. Fork the repository
2. Create your feature branch (`git checkout -b feat/amazing-feature`)
3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
4. Push to the branch (`git push origin feat/amazing-feature`)
5. Open a Pull Request

---

## 🌟 Credits

Inspired by [gemini-voyager](https://github.com/Nagi-ovo/gemini-voyager) — an all-in-one enhancement suite for Google Gemini.

---

## 📄 License

MIT License © 2026

<div align="center">
Made with ❤️ for Claude users
</div>