Home/AI Agents/duet-gpt
duet-gpt logo

duet-gpt

kristoferlund/duet-gpt

A conversational semi-autonomous developer assistant.

GraphCanon updated 1w · GitHub synced 1w

168 stars13 forksLast push 3y TypeScript MIT

Decision brief

DuetGPT empowers developers through conversational support for coding and system tasks.

Good fit when

  • You need assistance in generating or refactoring code, where DuetGPT uses the advanced capabilities of OpenAI's GPT-4 to suggest improvements or write new functions based on your specifications.
  • General bash scripting is required, such as listing items from a database with specific queries, and you'd like immediate suggestions to guide your CLI tasks.

Avoid when

  • For automated task executions where high reliability is imperative. DuetGPT may generate commands that require manual oversight before execution.
  • In situations requiring strict control over function calls, as it relies on the OpenAI API's function calling feature, which might not fully cover specific enterprise workflows.
Pricing:
freemium - Free to use; however, users need their own OpenAI API keys with potential costs based on usage.

Observed Jul 12, 2026 · Source: enrich:decision_facts

Verify the decision

Adoption

Package downloads where a registry match exists. GitHub stars (168) are secondary evidence.

npm downloads (30d)
39·npm downloads API·1w

Maintenance and security

Full trust report
Maintenance
Dormant (1152d since push)
As of 1w
Provenance
Not a fork · Personal account
As of 1w
Security (OSV)
49 low (49 low)
As of 1mo

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

npm install duet-gpt
npm

Similar tools

Same-category neighbours. No typed graph edges are catalogued for this tool yet.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

DuetGPT is an experimental AI-powered CLI tool that acts as a semi-autonomous agent for developers to assist with coding and file system tasks. It uses OpenAI's GPT-4 model and function calling API features.

Capability facts

CLI
CLI entrypoint

Source: package.json:bin|scripts · Aug 14, 2026

MCP server
No MCP server detected

Source: repo_scan · Aug 14, 2026

Languages
typescript, javascript

Source: github.language+package.json · Aug 14, 2026

Categories

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

LangChain integrationLangChain

Source: README excerpt (regex_v1, Aug 14, 2026)

**🎉 News:** DuetGPT no longer uses langchain but instead [OpenAI functions](https://openai.com/blog/function-calling-and-oth
Source link
Node.js runtimeNode.js

Source: README excerpt (regex_v1, Aug 14, 2026)

Here is a 30 second demo, use DuetGPT to build a Node.js app that draws a mandelbrot fractal using ASCII characters to the console:
Source link
OpenAI APIOpenAI API

Source: README excerpt (regex_v1, Aug 14, 2026)

-way conversation with the developer. It uses the newly released feature of the OpenAI API that allows the AI to make [function calls](https://openai.com/blog/function-ca
Source link

Tags

README

DuetGPT

🎉 News: DuetGPT no longer uses langchain but instead OpenAI functions. This means a significant improvement in reliability and performance.

DuetGPT is an experimental AI powered CLI tool and semi-autonomous agent that helps developers with coding tasks and file system tasks. The developer describes tasks to the AI who then issues commands or follow-up questions for clarification. After approval by the developer, DuetGPT automatically executes the commands issued by the AI.

DuetGPT also does really well as a general bash helper.

Works with OpenAI models:

  • gpt-3.5-turbo-0613 (does not produce any great code though)
  • gpt-4-0613

Example tasks:

  • Refactor index.js: add inline comments, improve variable naming.
  • Write a bash script that lists all cars in the database.
  • Find all files in current directory and subdirectories that contain the word "DuetGPT"
  • Write a PR description based on the commit messages in the PR.

DuetGPT builds on OpenAI's GPT-4 language model and uses its conversational capabilities to engage in a two-way conversation with the developer. It uses the newly released feature of the OpenAI API that allows the AI to make function calls.

⚠️ DuetGPT has no guardrails! Make sure you understand the commands given by the AI before executing them. ⚠️

Here is a 30 second demo, use DuetGPT to build a Node.js app that draws a mandelbrot fractal using ASCII characters to the console:

https://github.com/kristoferlund/duet-gpt/assets/9698363/147bdf9d-28df-4421-9297-05abfeb53142

Setup

Install the DuetGPT CLI tool globally using npm:

npm install -g duet-gpt

Usage

To start DuetGPT, run the following command:

duet-gpt

You will be prompted to enter your OpenAI API key. You can find your API key on the OpenAI dashboard.

     _            _              _
    | |          | |            | |
  __| |_   _  ___| |_ __ _ _ __ | |_
 / _` | | | |/ _ \ __/ _` | '_ \| __|
| (_| | |_| |  __/ || (_| | |_) | |_
 \__,_|\__,_|\___|\__\__, | .__/ \__|
                      __/ | |
                     |___/|_|

┌  DuetGPT
│
◆  Please enter your OpenAI API key:
│  sk-XXX…
└

Setup for development

  1. Clone the repository.

  2. Install dependencies:

npm install
  1. Run DuetGPT using yarn:
npm start

Sample interaction

For the purposes of illustrating how interactions work, I chose a super simple task. Let's say you want to add .yarn/cache to .gitignore. Here is how to ask DuetGPT to help you with that:

     _            _              _
    | |          | |            | |
  __| |_   _  ___| |_ __ _ _ __ | |_
 / _` | | | |/ _ \ __/ _` | '_ \| __|
| (_| | |_| |  __/ || (_| | |_) | |_
 \__,_|\__,_|\___|\__\__, | .__/ \__|
                      __/ | |
                     |___/|_|

┌  DuetGPT
│
◇  LLM and memory started
│
┌ 🤖 ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                                                                                            │
│                                                                                                                            │
│    My mission is to collaborate with you as a developer by providing specific bash or file modification commands to help   │
│    you complete your development-related tasks, while effectively engaging in two-way interactions.                        │
│                                                                                                                            │
│                                                                                                                            │
└───────────────────────────────────────────────────────

For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.