You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
74 lines
1.6 KiB
Markdown
74 lines
1.6 KiB
Markdown
# Claude Integration Development Notes
|
|
|
|
## Quick Start
|
|
|
|
1. Check task progress: `./check-tasks.sh`
|
|
2. View tasks: `nvim tasks.md`
|
|
3. Start implementing: Begin with Phase 1 tasks
|
|
|
|
## Key Files
|
|
|
|
- `tasks.md` - Comprehensive task tracking (gitignored)
|
|
- `check-tasks.sh` - Progress tracking script (gitignored)
|
|
- `lua/nvim-claude/` - Plugin code (to be created)
|
|
- `lua/colinzhao/lazy/claude.lua` - Plugin config (to be created)
|
|
|
|
## Development Workflow
|
|
|
|
1. Pick a task from `tasks.md`
|
|
2. Implement the feature
|
|
3. Test it thoroughly
|
|
4. Mark task as complete: Change `- [ ]` to `- [x]`
|
|
5. Run `./check-tasks.sh` to see progress
|
|
|
|
## Testing Commands
|
|
|
|
```bash
|
|
# Test plugin loading
|
|
nvim -c "echo 'Plugin loaded'" -c "qa"
|
|
|
|
# Test specific commands (once implemented)
|
|
nvim -c "ClaudeChat"
|
|
nvim -c "ClaudeBg 'test task'"
|
|
```
|
|
|
|
## Git Worktree Commands (for reference)
|
|
|
|
```bash
|
|
# List worktrees
|
|
git worktree list
|
|
|
|
# Add new worktree
|
|
git worktree add .agent-work/2024-01-15-feature main
|
|
|
|
# Remove worktree
|
|
git worktree remove .agent-work/2024-01-15-feature
|
|
```
|
|
|
|
## Tmux Commands (for reference)
|
|
|
|
```bash
|
|
# Split pane horizontally
|
|
tmux split-window -h -p 40
|
|
|
|
# Name current pane
|
|
tmux select-pane -T "claude-chat"
|
|
|
|
# List panes with names
|
|
tmux list-panes -F "#{pane_id} #{pane_title}"
|
|
|
|
# Send keys to specific pane
|
|
tmux send-keys -t %1 "echo 'Hello'" Enter
|
|
```
|
|
|
|
## Architecture Notes
|
|
|
|
- **Tmux-first**: All Claude interactions in tmux panes
|
|
- **Git worktrees**: For agent isolation
|
|
- **State management**: JSON files in `.agent-work/.state/`
|
|
- **No nvim terminal**: Respect existing workflow
|
|
|
|
## Current Status
|
|
|
|
- Phase: Planning → Implementation
|
|
- Next: Create plugin skeleton (Task 1.1) |