Claippy - AI-Powered Coding Assistant

Claippy is a command-line tool that provides an interactive interface for code assistance and conversation management.

Example Workflow

# Create an empty conversation
❯ cl new
Created conversation -2025-01-15T18:53:37.969677819+00:00

# Add files or URLs as context
❯ cl add src/repl.rs src/main.rs
Added context:
src/repl.rs
src/main.rs

# enter REPL mode
❯ cl

# Run a command from the repl
claippy> !add src/command.rs
Added context:
src/command.rs

# Interact with claippy
claippy> please implement a remove from context command
I'll help implement a remove from context command. Let's break this down into steps:
...

Commands

Basic Commands

• repl or no command: Start an interactive REPL session

  claippy
  # or
  claippy repl

• query or q: Send a one-off query

  claippy query How do I implement a binary search?
  # or
  claippy q How do I implement a binary search?

Conversation Management

• new or n: Create a new conversation

  claippy new my-project
  # Creates a conversation with ID "my-project"

• clear: Clear the current conversation history

  claippy clear

• history: Display the full conversation history

  claippy history

Context Management

Claippy allows you to manage the context provided to the assistant during conversations.

Adding Context

Add files or URLs to the conversation context:

claippy> !add src/main.rs src/lib.rs

or the shorter form:

claippy> !a https://example.com/api-docs.html

Removing Context

Remove files or URLs from the conversation context:

claippy> !remove src/main.rs src/lib.rs

or the shorter form:

claippy> !rm https://example.com/api-docs.html

Listing Context

List all files and URLs currently in the conversation context:

claippy> !ls

Clearing All Messages

Clear all messages in the conversation while keeping the context:

claippy> !clear

Usage with fzf

fzf is a command line fuzzy finder tool. Setting up fzf reduces friction with selecting source code files with the add command.

For example, in zsh the following turns ctrl-h into a project file selection shortcut:

populate-git-file() {
    dir=$(git rev-parse --show-toplevel 2>/dev/null || echo '.')
    files=$(rg --files $dir | fzf -m --height=15 --reverse | paste -s -)
    if [[ -n $files ]]; then
        LBUFFER+="${files}"
    fi
    zle reset-prompt
}
zle -N populate-git-file
bindkey "^h" populate-git-file

REPL Commands

When in REPL mode, you can use these commands by prefixing them with !:

• !new <name>: Create new conversation
• !clear: Clear current conversation
• !add <paths>: Add context files
• !ls: List context
• !history: Show conversation history
• !q <query>: Execute a query

To exit the REPL, use Ctrl+C or Ctrl+D.

Examples

# Start a new conversation about a specific project
claippy new rust-project

# Add some context files
claippy add src/*.rs

# Start an interactive session
claippy

# In REPL mode:
claippy> How can I improve this code?
claippy> !clear  # Clear the conversation
claippy> !ls     # Check current context

TODO

• REPL-based file selection
• Better configuration
• Better streaming source code highlighting?