kickstart.nvim/claude-integration-dev.md

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

# 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)

# 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)

# 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)