DEDUPED Hot AI repos, turned into use cases Get the Monday 5
140 stars · Python

How to use Clux Mate: what you can do with it

What is Clux Mate? CluxMate is an open-source AI coding agent in Python that reads a codebase, plans changes, edits files, runs commands, and answers questions, through a headless CLI, a Textual TUI, or an Electron desktop app.

How do I use it? Install Clux Mate by following the install section of the README; then point Clux Mate at your provider by setting its base_url to an OpenAI-compatible endpoint, as the README describes; run cluxmate -p "Fix the failing unit tests in <path> and summarize what you changed" from the repository root. Full steps below.

Trended earlier

View repo on GitHub

Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer

What do you want to do?

4 use cases

  • Run a one-shot coding fix from a script or CI job

    Send one prompt to the headless CLI and review the file changes it makes.

    View prompt
    Use the CluxMate repo (r1c7/CluxMate) to run the headless command cluxmate -p with a prompt that targets <path>. Expected output: a short summary from the agent and a set of changed files. Verify with git diff that only files inside <path> changed and that the tests named in the prompt now pass.

  • Run parallel agent tasks in separate git worktrees

    Give each task its own linked worktree and branch so sessions stop editing the same files.

    View prompt
    Use the CluxMate repo (r1c7/CluxMate) to create a separate worktree for the task <task name> with cluxmate worktree. Expected output: a new linked git worktree on its own branch. Verify with git worktree list that the new tree exists and that the main working directory is unchanged.

  • Audit an agent's claims against its session log

    Check whether an agent's 'done' matches the tool calls that actually ran.

    View prompt
    Use the CluxMate repo (r1c7/CluxMate) to run the task <task> and then inspect its session .jsonl log. Expected output: the turn/end entry with completion_audit and a list of claims checked. Verify that every claimed file change appears in git diff.

  • Get a read-only code review from a reviewer subagent

    Delegate a review to a subagent that is restricted to evidence and cannot edit files.

    View prompt
    Use the CluxMate repo (r1c7/CluxMate) to ask the reviewer subagent to review <files or diff>. Expected output: a review report with a status header. Verify that the reviewer made no file edits by checking git status before and after.

Quick start with Clux Mate

  1. Check you have what it needs: A CluxMate install (install steps are not in the README excerpt provided, so follow the README's install section); An OpenAI-compatible API endpoint, its base_url, and an API key; A git repository for the project you want the agent to work on.
  2. Open r1c7/CluxMate on GitHub and read the README and license.
  3. Install Clux Mate by following the install section of the README.
  4. Point Clux Mate at your provider by setting its base_url to an OpenAI-compatible endpoint, as the README describes.
  5. Run cluxmate -p "Fix the failing unit tests in <path> and summarize what you changed" from the repository root. (inferred, check the README)
  6. Run git diff and read every changed file before you commit anything. (inferred, check the README)

These steps come from our top use case, Run a one-shot coding fix from a script or CI job, which also has a copy-paste agent prompt.

Use this in your AI agent

Ask your agent

Using the Deduped MCP, get the setup steps for r1c7/CluxMate

Add Deduped to Claude Code once

claude mcp add --transport http deduped https://dedupedai.com/mcp

Cursor, ChatGPT, others

Clux Mate alternatives · Best AI repos for Software and DevOps

About this repo

  • Who it is forDevelopers and CI maintainers who want an agent that works on a local repository with permission tiers, a sandbox, and a replayable session log.
  • Why it is hot140 stars, launched 62 days ago
  • LanguagePython
  • Sourcegithub.com/r1c7/CluxMate · Back to Hot repos

Requirements

  • A CluxMate install (install steps are not in the README excerpt provided, so follow the README's install section)
  • An OpenAI-compatible API endpoint, its base_url, and an API key
  • A git repository for the project you want the agent to work on

Add this badge to your README

Maintain Clux Mate? Show readers where to find these use cases. Use cases on Deduped

Markdown 

[![Use cases on Deduped](https://dedupedai.com/badge/r1c7/CluxMate.svg)](https://dedupedai.com/use-cases/r1c7-cluxmate/?utm_source=github&utm_medium=badge&utm_campaign=r1c7-CluxMate)

HTML 

<a href="https://dedupedai.com/use-cases/r1c7-cluxmate/?utm_source=github&amp;utm_medium=badge&amp;utm_campaign=r1c7-CluxMate"><img src="https://dedupedai.com/badge/r1c7/CluxMate.svg" alt="Use cases on Deduped" height="20"></a>

A static image, no tracking script. About the badge

Questions about Clux Mate

What is Clux Mate?

CluxMate is an open-source AI coding agent in Python that reads a codebase, plans changes, edits files, runs commands, and answers questions, through a headless CLI, a Textual TUI, or an Electron desktop app. It is an open-source project on GitHub: https://github.com/r1c7/CluxMate.

How do I use Clux Mate?

Install Clux Mate by following the install section of the README; then point Clux Mate at your provider by setting its base_url to an OpenAI-compatible endpoint, as the README describes; run cluxmate -p "Fix the failing unit tests in <path> and summarize what you changed" from the repository root. The use cases on this page give the full steps and a copy-paste agent prompt for each job.

Who is Clux Mate for?

Developers and CI maintainers who want an agent that works on a local repository with permission tiers, a sandbox, and a replayable session log.

What can I do with Clux Mate?

4 use cases so far, for example: Run a one-shot coding fix from a script or CI job; Run parallel agent tasks in separate git worktrees; Audit an agent's claims against its session log. Each has steps and a copy-paste agent prompt.

What do I need to run Clux Mate?

A CluxMate install (install steps are not in the README excerpt provided, so follow the README's install section); An OpenAI-compatible API endpoint, its base_url, and an API key; A git repository for the project you want the agent to work on.

What are alternatives to Clux Mate?

Other hot AI repos in Software and DevOps: Deep Infer, Harness2, Orca, Opencode, Graphify.

Is Clux Mate safe to run?

Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.