[ Web Proxy ]
URL:
Viewing: https://commandcode.ai/docs/workflows [Back]  [Original]
Common Workflows | Command Code - Command Code Docs
Toggle SidebarCommand Code [Command Code]Command Code [Command Code]

Common workflows

Step-by-step recipes for everyday tasks. Each workflow shows a concrete scenario, the prompts to use, and what to expect.

Table of contents

Understand a new codebase

Start Command Code in the project root and ask for a high-level overview, then drill into specifics.

1

Get a broad overview

Ask for overview

> give me a brief overview of this codebase - structure, key packages, and entry points
Copy
2

Explore the architecture

Architecture

> explain the architecture patterns used here and how the modules connect
Copy
3

Zoom into a specific area

Dive deeper

> how is the payment system implemented? walk me through the flow from checkout to confirmation
Copy
Tip

Taste learning shows up inline as it happens: a green TASTE row lands in the transcript with what was learned, its confidence, and a link to the taste.md it was written to.

Reference files and directories

Use @ to include files or directories in any prompt. This gives Command Code the exact context it needs.

1

Reference a single file

Reference file

> explain the validation logic in @src/lib/auth.ts
Copy

This helps Command Code focus on the right file and provide targeted suggestions.

2

Reference a directory

Reference directory

> look at @src/app/api and explain the route structure
Copy

Command Code reads the directory listing and explains how the files relate.

3

Use the IDE extension for instant context

If you're using an IDE like Visual Studio Code or Cursor, install the Command Code extension with /ide or cmd --ide-setup. Once installed, selecting lines of code or clicking a file in your editor automatically injects that context into your prompt. No need to reference file paths manually with @.

Tip

@ triggers autocomplete for files and directories - start typing and press tab to select.

Find and fix bugs

Share an error, let Command Code trace the root cause, and apply the fix.

1

Share the error

Report error

> I'm seeing a TypeError when I run `pnpm dev` - "Cannot read properties of undefined (reading 'map')"
Copy
2

Find the root cause

Trace bug

> find where this error originates and explain why it happens
Copy
3

Apply the fix and verify

Fix bug

> fix the bug in @src/components/UserList.tsx and run `pnpm dev` to verify
Copy
Tip

Paste the full stack trace into the prompt - Command Code uses it to pinpoint the exact file and line causing the error.

Refactor code

Modernize a module while keeping behavior identical.

1

Identify what to refactor

Refactor target

> refactor @src/api/client.ts from callbacks to async/await - keep the same public API
Copy
2

Review and apply changes

Command Code shows a diff. Approve the edits or ask for adjustments before they're written.

3

Run tests to confirm

Verify

> run the tests for the API client to make sure nothing broke
Copy
Safety net

Press Esc twice to open the checkpoint selector and rewind if the refactor went wrong.

Write tests

Add tests for a module using the testing framework your project already uses.

1

Generate tests

Add tests

> add tests for @src/lib/auth.ts using Vitest - cover the happy path, invalid tokens, and expired sessions
Copy
2

Run and iterate

Run tests

> run the tests and fix any failures
Copy
3

Add edge cases

Edge cases

> add edge case tests for concurrent session limits and malformed JWTs
Copy
Tip

Ask Command Code to run tests after writing them - it catches failures and iterates until the suite passes.

Create a pull request

Review changes, generate a PR, and polish the description - all without leaving the terminal.

1

Review your changes

Summarize

> summarize the changes I've made to the auth module and check for anything I missed
Copy
2

Create the PR

Create PR

> create a pull request for these changes with a clear description and test plan
Copy

Command Code generates the title, description, and test plan using your commit history and diff.

3

Polish the description

Improve PR

> add a section about migration steps and link to the relevant RFC
Copy
Tip

Command Code requires the GitHub CLI (gh) to create PRs. Install and authenticate it first.

Fix a UI bug from a screenshot

Paste a screenshot of the broken UI directly into the terminal and let Command Code identify and fix the issue.

1

Share the screenshot

Copy a screenshot to your clipboard and paste it into the terminal, or reference an image file:

Reference image

> the modal is broken - here's what QA reported @screenshots/broken-modal.png
Copy
2

Identify the issue

Command Code analyzes the image, identifies the visual bug (overlapping elements, wrong spacing, missing styles), and locates the responsible component.

3

Apply the fix

Fix UI

> fix the z-index and padding issues in @src/components/Modal.tsx
Copy
Tip

Reference images with @path/to/screenshot.png - Command Code reads them like any other file. To paste one straight from your clipboard, press ctrl+v - see Pasting images.

Resume previous conversations

Pick up where you left off with --continue (most recent) or --resume (conversation picker).

1

Continue the most recent conversation

Continue

cmd --continue
Copy

This resumes your last conversation immediately.

2

Browse and select a past conversation

Resume picker

cmd --resume
Copy

This displays an interactive picker:

Modified # Messages Git Branch Summary 1. 20 hours ago 172 main Follow this practice and up... 2. 21 hours ago 13 main Add the common workflows he... 3. 22 hours ago 2 main does this {src/components/u... 4. 22 hours ago 82 main pnpm dlx shadcn@latest add ... 5. 1 day ago 2 ankit/features all tools support you have 6. 2 days ago 20 ankit/commands Update the content in each ...
Copy

Use arrow keys to navigate, Enter to select, Esc to exit.

Taste

Your taste profile carries between sessions - Command Code remembers your preferences even in new conversations.

Plan before you build

Use plan mode to explore the codebase and design an approach before any files change.

1

Enter plan mode

Start plan mode

cmd --plan
Copy

Or press shift+tab inside an active session to cycle into plan mode.

2

Describe what you want to build

Plan prompt

> design a role-based access control system for the API - explore the current auth setup first
Copy

Command Code reads files and proposes an implementation plan without making changes.

3

Review the plan and execute

Review the proposed steps. Approve to let Command Code implement them, or refine the plan first.

Read-only

Plan mode is read-only - Command Code explores but does not change files until you approve. See Plan mode.

Sync taste across machines

Push your taste profile to the cloud and pull it on another machine.

1

Push from your current machine

Push taste

cmd taste push
Copy
2

Pull on another machine

Pull taste

cmd taste pull
Copy
3

Verify your profiles

List taste

cmd taste list
Copy

This shows all taste profiles synced to your account. Manage your taste at Command Code Studio.

Equivalents

cmd taste and npx taste are equivalent. See Taste commands for the full list.

Review a pull request

Use the /review command to get an analysis of a PR without leaving the terminal.

1

Start the review

Review PR

/review 42
Copy

Command Code fetches the PR diff, analyzes the changes, and provides a structured review.

2

Read the analysis

The review covers code quality, potential bugs, missing tests, and style issues.

3

Fetch PR comments to address feedback

Fetch PR comments

/pr-comments
Copy

Retrieves all PR comments - issue comments and inline review comments - from the pull request associated with your current branch so you can address feedback directly in your session.

4

Leave comments

Comment on PR

> add a comment on the PR about the missing error handling in the webhook handler
Copy
Tip

Use /pr-comments on your feature branch to pull in all review feedback and address comments without leaving the terminal.

Share a debugging session

Create a shareable link to show teammates what you've tried.

1

Debug with Command Code

Work through the problem in a normal session - reproduce the bug, investigate, try fixes.

2

Share the session

Share

/share
Copy

This copies a shareable link to your clipboard.

3

Stop sharing when done

Unshare

/unshare
Copy
Privacy

Local file paths are automatically removed from shared conversations.

Write complex prompts with an external editor

Press ctrl+g to open your $EDITOR for multi-line prompts with code examples.

1

Open your editor

Press ctrl+g in the input line. Your configured $EDITOR opens with a temporary file.

2

Write your prompt

Write a detailed, multi-paragraph prompt. Include code examples, constraints, or references. Save and close the editor.

3

Submit

The editor content becomes your prompt and is submitted automatically.

Setup

Set your editor: export EDITOR=vim or export EDITOR="code --wait". See Setting up your editor.

What's next

Questions or feedback? Join the Discord community.

Table of ContentsOn This Page
Pricing & Limits// NEXT
// PREVQuickstart

Join our Discord

Chat with us and become part of the Command Code community.

Join Discord

Need help?

Open an issue on GitHub, ask on Discord, or reach out on .

Get help
2261 Market St #5698, San Francisco, CA 94114.
Follow us on XFollow on LinkedInJoin our Discord serverFollow us on GitHub
Web Proxy Viewer  |  New URL  |  Original Page