https://github.com/anubissbe/claude-code-tools
Enhanced tools and utilities for Claude Code - bash scripts, Python utilities, and automation tools to extend Claude Code capabilities
https://github.com/anubissbe/claude-code-tools
automation bash claude-ai cli-tools developer-tools python
Last synced: 19 days ago
JSON representation
Enhanced tools and utilities for Claude Code - bash scripts, Python utilities, and automation tools to extend Claude Code capabilities
- Host: GitHub
- URL: https://github.com/anubissbe/claude-code-tools
- Owner: anubissbe
- License: mit
- Created: 2025-06-11T16:27:23.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-06-11T16:35:11.000Z (8 months ago)
- Last Synced: 2025-06-11T18:02:47.963Z (8 months ago)
- Topics: automation, bash, claude-ai, cli-tools, developer-tools, python
- Language: Shell
- Size: 26.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Claude Code Tools
A comprehensive toolkit that enhances Claude Code's capabilities with powerful bash scripts, Python utilities, and automation tools.
## 🚀 Quick Start
```bash
# Use the quick launcher
/opt/claude-code-tools/cc
# Or add to PATH for easier access
export PATH="/opt/claude-code-tools:$PATH"
cc
```
## 📦 Installation
The tools are already installed at `/opt/claude-code-tools/`. To make them more accessible:
```bash
# Add to your .bashrc or .zshrc
echo 'export PATH="/opt/claude-code-tools:$PATH"' >> ~/.bashrc
echo 'source /opt/claude-code-tools/.claude_aliases' >> ~/.bashrc
source ~/.bashrc
```
## 🛠️ Available Tools
### 1. Quick Launcher (`cc`)
The main entry point for all Claude Code tools.
```bash
cc search [path] # Search files with content preview
cc analyze [path] # Analyze project structure
cc serve [port] # Start HTTP server
cc monitor # System resource monitor
cc json # Analyze JSON structure
cc csv2db # Convert CSV to SQLite
cc backup # Backup files/directories
```
#### Examples:
```bash
# Search for TODO comments
cc search "TODO" .
# Analyze current project
cc analyze
# Start web server on port 3000
cc serve 3000
# Check system resources
cc monitor
# Analyze JSON structure
cc json data.json
# Convert CSV to SQLite database
cc csv2db sales_data.csv
# Backup a directory
cc backup ./important-project
```
### 2. Bash Utilities (`cc-utils.sh`)
Enhanced bash functions for common development tasks.
```bash
# Load the utilities
source /opt/claude-code-tools/scripts/cc-utils.sh
```
#### Available Functions:
- **`search_files [path]`** - Search with content preview
- **`analyze_project [path]`** - Comprehensive project analysis
- **`query_db `** - SQLite query helper
- **`json_pretty `** - Pretty print JSON
- **`serve_dir [port]`** - Python HTTP server
- **`sys_monitor`** - System resource monitor
- **`context_grep [path] [lines]`** - Grep with context
- **`backup_files `** - Timestamped backups
- **`create_from_template `** - Project templates
#### Examples:
```bash
# Load utilities
source /opt/claude-code-tools/scripts/cc-utils.sh
# Search with preview
search_files "class.*User" ./src
# Analyze project structure
analyze_project ~/my-project
# Query SQLite database
query_db ./app.db "SELECT * FROM users LIMIT 5"
# Pretty print JSON
json_pretty response.json
# Grep with 5 lines of context
context_grep "error" ./logs 5
# Create Python project from template
create_from_template python my-api
```
### 3. Python Tools (`cc_tools.py`)
Advanced Python utilities for data processing and analysis.
```bash
python3 /opt/claude-code-tools/python-utils/cc_tools.py [args]
```
#### Commands:
- **`analyze-json `** - Analyze JSON file structure
- **`csv-to-sqlite `** - Convert CSV to SQLite database
- **`generate-report `** - Generate markdown reports
- **`batch-process`** - Process multiple files
#### Examples:
```bash
# Analyze complex JSON
python3 /opt/claude-code-tools/python-utils/cc_tools.py analyze-json api_response.json
# Convert CSV to queryable database
python3 /opt/claude-code-tools/python-utils/cc_tools.py csv-to-sqlite sales_2024.csv
# Generate report from data
python3 /opt/claude-code-tools/python-utils/cc_tools.py generate-report data.json --format markdown
# Batch process files
python3 /opt/claude-code-tools/python-utils/cc_tools.py batch-process \
--pattern "*.log" \
--command "grep ERROR {file} | wc -l"
```
### 4. Automation Scripts
Located in `/opt/claude-code-tools/automation/`
#### auto-commit.sh
Intelligent git commit message generator.
```bash
# Stage your changes first
git add .
# Generate and create commit
/opt/claude-code-tools/automation/auto-commit.sh
```
Features:
- Analyzes staged changes
- Generates descriptive commit messages
- Lists all modified files
- Categorizes changes (Add/Update/Remove)
### 5. Project Templates
Pre-configured project structures for quick starts.
#### Python Project Template
```bash
cc template python my-project
cd my-project
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
Includes:
- `setup.py` for package configuration
- `requirements.txt` with common dependencies
- `.gitignore` with Python-specific patterns
#### Node.js Project Template
```bash
cc template node my-app
cd my-app
npm install
npm run dev
```
Includes:
- `package.json` with scripts
- Development dependencies (Jest, Nodemon)
- Basic project structure
### 6. Aliases
Load helpful aliases:
```bash
source /opt/claude-code-tools/.claude_aliases
```
Provides shortcuts for:
- **Git**: `gs` (status), `gd` (diff), `gc` (commit), `gp` (push)
- **Navigation**: `..`, `...`, `ll`, `lt`
- **Python**: `py`, `pip`, `venv`, `activate`
- **Docker**: `dps`, `dimg`, `dexec`
- **System**: `ports`, `process`
## 📊 Databases
Pre-configured SQLite databases in `/opt/claude-code-tools/databases/`:
### tools.db
Contains useful commands and code snippets:
```sql
-- Query useful commands
SELECT * FROM commands WHERE category = 'git';
-- Find code snippets
SELECT * FROM snippets WHERE language = 'python';
```
## 🔧 Advanced Usage
### Combining Tools
```bash
# Analyze JSON API response and convert to database
curl -s https://api.example.com/data | tee response.json
cc json response.json
python3 /opt/claude-code-tools/python-utils/cc_tools.py generate-report response.json
# Search project and create report
cc analyze ./src > project_analysis.md
cc search "TODO\|FIXME" . >> project_analysis.md
```
### Custom Workflows
```bash
# Development workflow
source /opt/claude-code-tools/scripts/cc-utils.sh
analyze_project
search_files "test" ./tests
serve_dir 8080
# Data processing workflow
cc csv2db data.csv
query_db data.db "SELECT COUNT(*) FROM data"
python3 /opt/claude-code-tools/python-utils/cc_tools.py generate-report data.db
```
## 🤝 Integration with Claude Code
These tools are designed to enhance Claude Code's built-in capabilities:
1. **File Operations**: Enhanced search and analysis beyond basic Read/Write
2. **Data Processing**: Convert between formats, analyze structures
3. **Automation**: Reduce repetitive tasks
4. **Templates**: Faster project initialization
5. **Monitoring**: Keep track of system resources
## 📝 Notes
- All tools work with Claude Code's existing permissions
- No external dependencies required (except standard Unix tools)
- Data stays local - no external API calls
- Tools can be chained together for complex workflows
## 🐛 Troubleshooting
### Command not found
```bash
# Ensure tools are in PATH
export PATH="/opt/claude-code-tools:$PATH"
# Or use full path
/opt/claude-code-tools/cc
```
### Permission denied
```bash
# Make scripts executable
chmod +x /opt/claude-code-tools/cc
chmod +x /opt/claude-code-tools/scripts/*.sh
chmod +x /opt/claude-code-tools/automation/*.sh
```
### Python module errors
```bash
# Install required Python packages
pip3 install pandas requests pyyaml
```
## 🚀 Examples Gallery
### Project Analysis Report
```bash
# Generate comprehensive project report
cc analyze > report.md
echo "## Code Search Results" >> report.md
cc search "class\|function" . >> report.md
echo "## TODO Items" >> report.md
cc search "TODO\|FIXME" . >> report.md
```
### Data Pipeline
```bash
# Download, analyze, and store data
curl -s https://example.com/data.json -o raw_data.json
cc json raw_data.json
python3 /opt/claude-code-tools/python-utils/cc_tools.py generate-report raw_data.json
```
### Backup Before Major Changes
```bash
# Create timestamped backup
cc backup ./my-project
# Make changes...
# If needed, restore from /opt/claude-code-tools/backups/
```
## 📚 Further Customization
Feel free to:
- Add your own functions to `cc-utils.sh`
- Create new automation scripts
- Extend the Python tools
- Add more project templates
- Create custom aliases
The toolkit is designed to be extensible and adaptable to your workflow!