claude-ime 0.2.2

Fix IME input for Claude Code — type Vietnamese, Chinese, Japanese, Korean, and more
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

# Contributing to claude-ime

Thank you for your interest in contributing! This guide covers building, testing, and submitting changes.

## Build Instructions

### Prerequisites

- Rust 1.56+ ([install](https://rustup.rs/))
- Cargo

### Build from Source

```bash
git clone https://github.com/agenon/claude-ime.git
cd claude-ime
cargo build --release
```

The binary will be at `target/release/claude-ime` (or `claude-ime.exe` on Windows).

### Run Tests

```bash
cargo test
```

All tests must pass before submitting a PR.

## Code Style

### Format Code

```bash
cargo fmt
```

All code must be formatted with `cargo fmt` before submission.

### Lint Code

```bash
cargo clippy
```

Address all warnings reported by `cargo clippy`. Use `#[allow(...)]` only when justified with an inline comment.

## Testing IMEs

When adding support for new IMEs or fixing composition bugs, test with real IMEs:

### macOS

1. **Enable language**: System Preferences → Keyboard → Input Sources → Add (e.g., Vietnamese, Simplified Chinese)
2. **Switch input source**: Cmd+Space → select language
3. **Run claude-ime**:
   ```bash
   cargo run -- --verbose
   ```
4. **Type in the target language**: Verify no garbling, characters appear correctly
5. **Check logs**: Watch for UTF-8 boundary crossings in verbose output

### Linux (fcitx)

1. **Install fcitx and IME** (example: Unikey for Vietnamese):
   ```bash
   sudo apt install fcitx fcitx-unikey
   ```
2. **Configure fcitx**: `fcitx-configtool`
3. **Set input method**: `XIM=fcitx XMODIFIERS=@im=fcitx claude-ime --verbose`
4. **Type and verify**

### Windows (IME Support)

1. **Enable IME**: Settings → Devices → Typing → Input method
2. **Run claude-ime**:
   ```bash
   cargo run -- --verbose
   ```
3. **Type** and verify UTF-8 handling

## PR Process

1. **Fork** the repository
2. **Create a branch**: `git checkout -b fix/your-issue` or `feat/your-feature`
3. **Make changes** and test locally
4. **Run checks**:
   ```bash
   cargo fmt
   cargo clippy
   cargo test
   ```
5. **Commit** with a clear message:
   ```
   feat: support new IME composition mode
   fix: handle incomplete UTF-8 sequences
   ```
6. **Push** and open a PR with:
   - Clear description of the change
   - Link to related issue (if any)
   - Testing steps for IME fixes
   - Platform(s) tested on

## Issue Templates

### Bug Report

```
**Platform**: macOS / Linux / Windows
**Rust Version**: (output of `rustc --version`)
**IME**: Vietnamese Unikey / Chinese Sogou / etc.

**Describe the bug**:
When I type [description], [what happens].

**Expected behavior**:
[what should happen]

**Steps to reproduce**:
1. Enable IME
2. Run `claude-ime --verbose`
3. Type [example]

**Logs**:
```
[paste verbose output]
```
```

### Feature Request

```
**Title**: Brief feature description

**Use case**: Why do you need this?

**Proposed solution**: How would you like it to work?

**Alternative approaches**: Other ideas?
```

## Questions?

- Open a [GitHub Discussion](https://github.com/agenon/claude-ime/discussions)
- Check [existing issues](https://github.com/agenon/claude-ime/issues)

---

Thank you for improving claude-ime!