Cobuff

Cobuff is a terminal coding agent package by Yang. It keeps Codebuff's agent runtime and adds a Codex-style local workflow surface, including clearer ChatGPT login entry points and a per-thread /goal command.

Installation

Install Cobuff globally:

npm install -g cobuff

Use sudo only if your Node.js installation requires elevated global installs.

Usage

Start Cobuff from a project directory:

cd /path/to/project
cobuff

Or pass the project path explicitly:

cobuff --cwd /path/to/project

Inside Cobuff:

1. Choose ChatGPT account or Cobuff account when the login screen opens.
2. Type /goal <objective> to set the current thread goal.
3. Ask Cobuff to edit files, run tests, refactor code, or explain a codebase.
4. Press Esc or Ctrl+C while Cobuff is generating a response to stop it.

Short Command

The package also installs a shorter command:

cob --cwd /path/to/project

Release Binary Downloads

The npm package downloads the correct Cobuff binary for your platform the first time it runs. By default it downloads from the configured public GitHub release repository. Set COBUFF_RELEASE_REPOSITORY to point the wrapper at another public GitHub releases repo:

COBUFF_RELEASE_REPOSITORY=iyang1016/cobuff-releases cobuff

On Windows PowerShell:

$env:COBUFF_RELEASE_REPOSITORY = "iyang1016/cobuff-releases"
cobuff

You can also set COBUFF_RELEASE_BASE_URL if you host Cobuff release tarballs behind a compatible release server:

COBUFF_RELEASE_BASE_URL=https://your-release-host.example cobuff

On Windows PowerShell:

$env:COBUFF_RELEASE_BASE_URL = "https://your-release-host.example"
cobuff

The release server must serve tarballs at:

/api/releases/download/<version>/cobuff-<platform>-<arch>.tar.gz

For public npm installs, the release assets must be publicly downloadable. Keep source code in a private repository if needed, but host the binary tarballs in a public release repository or another public asset host.

Recommended Cobuff setup:

1. Keep the source repository private.
2. Create a separate public GitHub repository for binary releases, such as iyang1016/cobuff-releases.
3. Publish the npm wrapper publicly.
4. Upload the five cobuff-* tarballs to the public release repo for every npm version.

Upload existing local release assets with:

COBUFF_RELEASE_REPOSITORY=iyang1016/cobuff-releases COBUFF_GITHUB_TOKEN=ghp_your_token bun run --cwd cli release:upload-assets <version>

Supported artifact names:

cobuff-linux-x64.tar.gz
cobuff-linux-arm64.tar.gz
cobuff-darwin-x64.tar.gz
cobuff-darwin-arm64.tar.gz
cobuff-win32-x64.tar.gz

Corporate Proxy / Firewall

If you see Failed to download cobuff: Request timeout or Failed to determine latest version, you may be behind a corporate proxy or firewall.

Cobuff respects standard proxy environment variables. Set HTTPS_PROXY to route traffic through your proxy:

export HTTPS_PROXY=http://your-proxy-server:port
cobuff

On Windows PowerShell:

$env:HTTPS_PROXY = "http://your-proxy-server:port"
cobuff

Supported proxy environment variables:

| Variable | Purpose | |---|---| | HTTPS_PROXY / https_proxy | Proxy for HTTPS requests | | HTTP_PROXY / http_proxy | Fallback proxy for HTTP requests | | NO_PROXY / no_proxy | Comma-separated hostnames to bypass the proxy |

Both http:// and https:// proxy URLs are supported. Proxy authentication is supported through URL credentials.

Origin

Cobuff is a rebrand and product fork direction based on Codebuff, packaged for npm install -g cobuff.

License

Cobuff is distributed as proprietary software. This public npm package is an installer and update wrapper for Cobuff releases; it does not grant permission to copy, modify, redistribute, or publish Cobuff source or release artifacts unless Yang provides a separate written license.