c3l

README

C3L - Clipllama

Make your clipboard interact with an Ollama server.

Simply use Copy in any application and automatically attach it to your prompt!

Features

• Send a prompt to Ollama and automatically attach the clipboard content
• (Optionally) Update clipboard content with Ollama response
• (Optionally) Print to stdout
• Enable/Disable thinking mode of supported models like qwen3

Installation

go install github.com/FalconTube/c3l@latest

This will install the latest version of c3l on your system and put the c3l binary on your path.

Usage

The main command is c3l do, which takes the given <prompt> and the clipboard content and sends it to Ollama. Aliases are exec,ask,run.

$ c3l do --help
Usage: c3l do (exec,ask,run) <prompt> [flags]

Send <prompt> and clipboard content to Ollama

Arguments:
  <prompt>    Prompt being sent to Ollama

Flags:
  -h, --help                             Show context-sensitive help.

  -t, --[no-]think                       If true, uses thinking mode, if applicable in model.
                                         If false, adds '/no_think' to prompt
  -p, --[no-]print                       If true, prints response to stdout (default: true)
  -r, --[no-]replace                     If true, put Ollama output on clipboard
  -m, --model="qwen3:0.6b"               Ollama model to use. Available models:
                                         https://ollama.com/library
  -n, --[no-]notify                      If true, display tray notification when finished.
  -e, --[no-]expand                      Expand given prompt into long version, as defined in
                                         $HOME/.c3l.toml
      --ollama-host="127.0.0.1:11434"    IP Address for the Ollama server ($OLLAMA_HOST).```

All flags can be permanently set in a config file at $HOME/.c3l.toml. c3l has a config command to both initialize and list the content of this file.

$ c3l --help
Usage: c3l <command>

Takes the clipboard content + given prompt and sends it to Ollama

Flags:
  -h, --help    Show context-sensitive help.

Commands:
  do (exec,ask,run) <prompt> [flags]
    Send <prompt> and clipboard content to Ollama

  config init [flags]
    Create default config at $HOME/.c3l.toml

  config list
    List contents of config

Run "c3l <command> --help" for more information on a command.```

User Defined Prompts

You can save (long) prompts for easy, repeated use in c3l.

To do so, simply add your custom commands and abbreviations in the [prompts] section of the $HOME/.c3l.toml config file as such:

other flags
...

[prompts]
example = "Using the '--expand' flag with the word 'example' as the prompt will expand into this string."

Then use the --expand flag and pass your abbreviation (in this case example) to the cli e.g.:

c3l do "example" --expand
# Will turn into
# c3l do "Using the '--expand' flag with the word 'example' as the prompt will expand into this string."