claude-tools

🥈Silver

Claude-tools provides Unix-style utilities for managing Claude Code conversations. It implements a virtual filesystem abstraction, allowing users to interact with Claude conversations using familiar commands. This is useful for operations teams automating workflows and integrating Claude Code into existing systems.

1700Updated 1mo ago

Intermediate30min to implementautomation

Saves ~30 min per use

Quick InstallView Source

git clone https://github.com/dlond/claude-tools.git

Works with:

Claude

Overview

About This Skill

Claude-tools provides a suite of Unix-style utilities that treat Claude Code conversations as a virtual filesystem, enabling familiar command-line management. It includes tools for listing conversations, copying them (creating forks), moving conversations between projects, removing conversations, and cleaning up orphaned projects. The toolkit supports ghost directories—directories that have been deleted but still contain stored conversations—making it particularly useful for git worktree workflows. All mutation operations include metadata logging for audit trails. Installation is available via curl, Homebrew, Nix, or from source, with shell completions for bash and zsh.

How to Use

Install via curl (curl -sSL https://raw.githubusercontent.com/dlond/claude-tools/main/install.sh | bash), Homebrew (brew install claude-tools), Nix, or from source. Use claude-ls to list conversations, claude-cp to copy conversations between projects, claude-mv to move them while preserving UUIDs, claude-rm to remove conversations, and claude-clean to remove orphaned projects. Shell completions are automatically installed with Nix or can be manually sourced for bash/zsh.

Use Cases

Automating conversation backup and archival across multiple Claude Code projects

Integrating Claude Code workflows into existing CI/CD and DevOps systems

Managing conversations across git worktrees without losing conversation history

Cleaning up and reclaiming disk space from orphaned or stale projects

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/dlond/claude-tools

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I want to use Claude-tools to manage my Claude Code conversations. Here's what I need to do: [DESCRIBE TASK]. Can you guide me through the process using the appropriate commands?

Example Output

# Managing Claude Code Conversations with Claude-tools

## Listing Conversations
To see all your existing conversations, use the `ls` command:
```bash
$ ls
conversation_2023-01-01.txt
conversation_2023-01-02.txt
conversation_2023-01-03.txt
```

## Viewing a Specific Conversation
To view the contents of a specific conversation, use the `cat` command:
```bash
$ cat conversation_2023-01-01.txt
User: How do I set up a CI/CD pipeline?
Claude: To set up a CI/CD pipeline, you'll need to...
```

## Searching for Keywords
To search for specific keywords within your conversations, use the `grep` command:
```bash
$ grep -i 'CI/CD' *
conversation_2023-01-01.txt:User: How do I set up a CI/CD pipeline?
conversation_2023-01-01.txt:Claude: To set up a CI/CD pipeline, you'll need to...
```