CLI Commands - Codebuff

The Codebuff CLI provides a rich set of slash commands for controlling the interface, managing agents, and accessing features. Commands start with / and can be typed in the input field.

Quick Reference

/help

Show help and shortcuts

/init

Initialize project

/new

Start new conversation

/publish

Publish custom agents

/usage

View credit usage

/bash

Execute shell commands

Session Management

/new (aliases: /n, /clear, /c, /reset)

Start a new conversation, clearing the current chat history.

/new

With initial prompt: Clear the conversation and immediately send a new prompt:

/new refactor the database connection logic

/history (aliases: /chats)

Browse and continue previous conversations.

/history

Use arrow keys to select a conversation and press Enter to continue it.

/exit (aliases: /quit, /q)

Exit the CLI application.

/exit

You can also use Ctrl+D to exit the CLI.

Project Setup

/init

Initialize your project with Codebuff configuration files.

/init

This command creates:

knowledge.md - Project context file for giving agents information about your project
.agents/ - Directory for custom agent definitions
.agents/types/ - TypeScript type definitions:
- agent-definition.ts - AgentDefinition interface
- tools.ts - Tool type definitions
- util-types.ts - Utility types

What gets created:

project/
├── knowledge.md
└── .agents/
    └── types/
        ├── agent-definition.ts
        ├── tools.ts
        └── util-types.ts

The knowledge.md template includes sections for:

Quickstart commands (setup, dev, test)
Architecture overview
Coding conventions
Patterns to follow and avoid

Fill out knowledge.md with project-specific details to help agents understand your codebase better.

Agent Management

/publish

Publish custom agents from your .agents/ directory to the Codebuff agent store.

/publish

This opens an interactive UI where you can:

Select which agents to publish
Review agent details
Confirm publication

Direct publish: Publish specific agents by ID or display name:

/publish my-agent
/publish my-agent another-agent

Requirements:

You must be logged in
Agents must have a valid publisher field
Agents must be in a .agents/ directory

Success output:

✅ Successfully published:
  - My Custom Agent (username/[email protected])

Error handling: The command provides detailed error messages:

Missing publisher field
Publisher not found or no access
Validation errors

Published agents are publicly available in the agent store. Make sure not to include sensitive information.

Agent Mode Commands

Switch between different agent modes:

/mode:default

Switch to DEFAULT mode (balanced performance).

/mode:default

With prompt:

/mode:default optimize the image processing pipeline

/mode:free

Switch to FREE mode (fast, economical).

/mode:free

/mode:max

Switch to MAX mode (maximum capability).

/mode:max

/mode:plan

Switch to PLAN mode (planning and strategy).

/mode:plan

Shell Integration

/bash (alias: !)

Enter bash mode to execute shell commands.

/bash

Once in bash mode, type commands normally (without the ! prefix). Press Escape to exit bash mode. Direct execution: Execute a command immediately:

/bash npm test
!git status
!ls -la

How it works:

Commands run in the current working directory
Output is captured and displayed in the chat
Exit codes are shown
Environment variables from your shell are preserved
Commands run synchronously (you see output as it streams)

Example:

!npm run build

$ npm run build
> [email protected] build
> tsc

Completed in 2.3s

Account & Usage

/usage (alias: /credits)

View your current credit usage and remaining balance.

/usage

Displays:

Current credit balance
Usage this month
Subscription tier (if applicable)
Renewal date

Open your browser to the subscription page.

/subscribe

This opens https://codebuff.com/subscribe in your default browser.

/refer-friends (aliases: /referral, /redeem)

Enter or redeem referral codes.

/refer-friends

Enters referral mode where you can paste a code. Press Escape to exit. Direct redemption:

/refer-friends ABC123

Notifies you that you’re already logged in. To switch accounts, use /logout.

/login

/logout (alias: /signout)

Log out of your Codebuff account.

/logout

This will:

Stop any running agents
Clear your authentication token
Return you to the login screen

Help & Information

/help (aliases: /h, /?)

Show the help banner with keyboard shortcuts and available commands.

/help

The help screen shows:

Common keyboard shortcuts
Command list with descriptions
Tips for effective usage

Press Escape or Backspace to close the help screen.

/feedback (aliases: /bug, /report)

Submit feedback or report bugs.

/feedback

Opens a feedback form where you can:

Describe the issue
Select feedback type
Include conversation context

Pre-filled feedback:

/feedback The image attachment feature isn't working

Attachments

/image (aliases: /img, /attach)

Attach images to your prompts.

/image

Enters image mode where you can:

Type a file path
Press Ctrl+V to paste from clipboard
Drag and drop images (in supported terminals)

Direct path:

/image ~/Screenshots/design.png
/image ./wireframe.jpg

Supported formats:

PNG, JPEG, GIF, WebP
Maximum 5MB per image
Multiple images per prompt

Use cases:

/image design.png
Implement this UI design using React and Tailwind

Advanced Commands

/review

Request a code review from the GPT-5 Agent.

/review

Opens a file selector where you can choose files to review. Direct review:

/review Check for security issues in the authentication code

This sends: @GPT-5 Agent Please review: Check for security issues in the authentication code

/theme:toggle

Toggle between light and dark themes.

/theme:toggle

The CLI automatically detects your terminal’s theme on startup. Use this command to override the detection.

/ads:enable

Enable promotional messages in the CLI.

/ads:enable

/ads:disable

Disable promotional messages in the CLI.

/ads:disable

Command Arguments

Many commands accept arguments that modify their behavior:

Commands without arguments

These commands don’t accept arguments. Any text after the command is ignored:

/help
/init
/exit
/login
/logout
/usage
/subscribe
/history
/theme:toggle
/ads:enable
/ads:disable

Commands with optional arguments

These commands work with or without arguments:

/new [prompt] - Start new chat, optionally with a prompt
/bash [command] - Enter bash mode or execute command
/image [path] - Enter image mode or attach specific file
/feedback [text] - Open feedback form, optionally pre-filled
/refer-friends [code] - Enter referral mode or redeem code
/review [instructions] - Open file picker or review with instructions
/mode:* [prompt] - Switch mode, optionally with a prompt

Commands requiring arguments

These commands require at least one argument:

/publish <agent-id> [agent-id...] - Publish one or more agents

Command Aliases

Many commands have shorter aliases for faster typing:

Full Command	Aliases
`/help`	`/h`, `/?`
`/new`	`/n`, `/clear`, `/c`, `/reset`
`/exit`	`/quit`, `/q`
`/bash`	`!`
`/usage`	`/credits`
`/subscribe`	`/strong`, `/sub`, `/buy-credits`
`/refer-friends`	`/referral`, `/redeem`
`/feedback`	`/bug`, `/report`
`/image`	`/img`, `/attach`
`/history`	`/chats`
`/login`	`/signin`
`/logout`	`/signout`

Command History

The CLI maintains a history of your commands:

Press Up/Down arrows to navigate history
Press Ctrl+R to search history
History persists across sessions
Separate history for bash commands

Tips

Command completion: Start typing / and press Tab to see command suggestions.

Bash shortcut: Use ! instead of /bash for quicker shell command execution.

Mode + prompt: Combine mode switches with prompts to change modes and start a task in one command.

Escape to exit: Press Escape to exit most special input modes and return to normal chat.

Get Started

Core Concepts

CLI Guide

SDK Guide

Agent Development

Advanced

​Quick Reference

/help

/init

/new

/publish

/usage

/bash

​Session Management

​/new (aliases: /n, /clear, /c, /reset)

​/history (aliases: /chats)

​/exit (aliases: /quit, /q)

​Project Setup

​/init

​Agent Management

​/publish

​Agent Mode Commands

​/mode:default

​/mode:free

​/mode:max

​/mode:plan

​Shell Integration

​/bash (alias: !)

​Account & Usage

​/usage (alias: /credits)

​/subscribe (aliases: /strong, /sub, /buy-credits)

​/refer-friends (aliases: /referral, /redeem)

​/login (alias: /signin)

​/logout (alias: /signout)

​Help & Information

​/help (aliases: /h, /?)

​/feedback (aliases: /bug, /report)

​Attachments

​/image (aliases: /img, /attach)

​Advanced Commands

​/review

​/theme:toggle

​/ads:enable

​/ads:disable

​Command Arguments

​Command Aliases

​Command History

​Tips

​Next Steps

Configuration

Workflows

Build docs developers (and LLMs) love

Quick Reference

Session Management

/new (aliases: /n, /clear, /c, /reset)

/history (aliases: /chats)

/exit (aliases: /quit, /q)

Project Setup

/init

Agent Management

/publish

Agent Mode Commands

/mode:default

/mode:free

/mode:max

/mode:plan

Shell Integration

/bash (alias: !)

Account & Usage

/usage (alias: /credits)

/subscribe (aliases: /strong, /sub, /buy-credits)

/refer-friends (aliases: /referral, /redeem)

/login (alias: /signin)

/logout (alias: /signout)

Help & Information

/help (aliases: /h, /?)

/feedback (aliases: /bug, /report)

Attachments

/image (aliases: /img, /attach)

Advanced Commands

/review

/theme:toggle

/ads:enable

/ads:disable

Command Arguments

Command Aliases

Command History

Tips

Next Steps