claude-utils 0.2.0

Cross-platform companion toolkit for Anthropic's Claude Code CLI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

# Contributing to Claude-Utils

First off, thank you for considering contributing to Claude-Utils! 🎉

## Code of Conduct

Be kind, respectful, and considerate. We're all here to make Claude Code better.

## How Can I Contribute?

### Reporting Bugs

1. Check if the issue already exists
2. Include:
   - OS and version
   - Claude-Utils version (`claude-utils --version`)
   - Steps to reproduce
   - Expected vs actual behavior
   - Error messages/logs

### Suggesting Features

1. Check existing issues/discussions
2. Explain the use case
3. Provide examples
4. Consider implementation approach

### Pull Requests

1. Fork the repo
2. Create feature branch (`git checkout -b feature/amazing-feature`)
3. Write tests for new functionality
4. Ensure all tests pass (`cargo test`)
5. Run clippy (`cargo clippy -- -D warnings`)
6. Format code (`cargo fmt`)
7. Commit with clear message
8. Push and create PR

## Development Setup

```bash
# Clone your fork
git clone https://github.com/josharsh/claude-utils
cd claude-utils

# Install Rust (if needed)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Build and test
cargo build
cargo test

# Run locally
cargo run -- start --watch --no-auth
```

## Project Structure

```
claude-utils/
├── src/
│   ├── bin/claude-utils.rs   # CLI entry point
│   ├── clipboard/            # Clipboard management
│   ├── file_manager/         # File staging
│   ├── mcp/                  # MCP protocol implementation
│   └── lib.rs               # Library root
├── tests/                    # Integration tests
└── docs/                     # Documentation
```

## Testing

- Unit tests: In module files
- Integration tests: In `tests/`
- Run all tests: `cargo test`
- Check code quality: `cargo clippy`

## Commit Messages

Follow conventional commits:
- `feat:` New feature
- `fix:` Bug fix
- `docs:` Documentation
- `chore:` Maintenance
- `test:` Tests
- `refactor:` Code restructuring

## Release Process

1. Update version in `Cargo.toml`
2. Update `CHANGELOG.md`
3. Create PR to `main`
4. After merge, maintainer creates release tag

## Questions?

Open an issue or discussion. We're happy to help!