Skip to main content
CodeFire includes a powerful terminal emulator (powered by SwiftTerm) embedded in every project window. No need to switch to a separate terminal app — run commands, launch agents, and manage multiple tabs without leaving CodeFire.

Multi-Tab Interface

The terminal supports unlimited tabs:
  • Click + to open a new tab
  • Each tab runs its own shell session
  • Tabs stay alive even when not visible
  • Close tabs with the × button (or Cmd+W)
Terminal with multiple tabs

Auto-Directory Sync

When you switch projects, CodeFire automatically runs cd in the active terminal tab to keep it in sync with the current project path.
This means you can switch between projects and immediately run git status or npm install without manually navigating directories.

Quick Launch Buttons

Each terminal has quick-launch buttons for all major AI coding CLIs:
  • Claude Codeclaude
  • Gemini CLIgemini
  • Codex CLIcodex
  • OpenCodeopencode
Click a button to open a new tab with that CLI pre-loaded and ready to accept prompts.
CodeFire detects which CLIs are installed and only shows available buttons.

Task Launcher Integration

Launch tasks directly from the task board:
  1. Right-click a task in the Kanban board
  2. Select Launch as Claude Session
  3. CodeFire opens a new terminal tab and runs:
    claude "Task: [title]\n\n[description]"
    
The task context (title, description, attachments) is passed to Claude as the initial prompt.

Dev Tools Quick Actions

The Dashboard tab includes one-click dev tools that run commands in the terminal:
  • Devnpm run dev (or equivalent for your package manager)
  • Buildnpm run build
  • Testnpm test
  • Lintnpm run lint
CodeFire auto-detects your package manager (npm, yarn, pnpm, bun) and adjusts commands accordingly.
Dev tools with quick-launch buttons

Terminal Features

Full VT100/xterm Support

Powered by SwiftTerm, the terminal supports:
  • Color output (ANSI escape codes)
  • Unicode characters
  • Mouse events (for apps like vim)
  • Scrollback buffer
  • Copy/paste (Cmd+C / Cmd+V)

Shell Sessions

Each tab runs a full shell session:
  • Uses your default shell ($SHELL)
  • Loads your shell config (.bashrc, .zshrc, etc.)
  • Supports all environment variables
  • Runs in the project directory by default

Tab Management

  • Cmd+T — New tab
  • Cmd+W — Close current tab
  • Cmd+Shift+[ — Previous tab
  • Cmd+Shift+] — Next tab
  • Click a tab to switch to it

Agent Monitoring

When Claude Code (or another AI CLI) is running, CodeFire displays an Agent Status Bar above the terminal:
  • 🟢 Active — Agent is running
  • 🟡 Thinking — Agent is processing
  • 🔴 Error — Agent encountered an error
This provides visual feedback without interrupting your workflow.
The status bar monitors the shell’s child processes to detect when an AI agent is active.

Copy to Clipboard

CodeFire provides a global notification for copying text to the clipboard:
  • When you select text in the GUI (e.g., a code snippet or diff)
  • Click Copy or press Cmd+C
  • The text is copied to your system clipboard
  • Paste into the terminal with Cmd+V
This makes it easy to move code between the GUI and terminal.

Best Practices

Open a new tab for dev servers, watchers, or background jobs. Switch to another tab to run commands while the process runs.
Instead of typing prompts manually, create a task with full context and launch it as a Claude session. This ensures the agent has all the details.
Reserve one tab for ad-hoc commands (git, ls, grep). Use other tabs for specific workflows (dev server, testing, agent sessions).
Quick-launch buttons ensure you’re using the right CLI with the right flags. Avoid typos by clicking instead of typing.

Keyboard Shortcuts

ShortcutAction
Cmd+TNew tab
Cmd+WClose tab
Cmd+Shift+[Previous tab
Cmd+Shift+]Next tab
Cmd+CCopy selected text
Cmd+VPaste
Cmd+KClear screen
Cmd+LClear scrollback

Project Management

Each project window has its own terminal panel

Task Tracking

Launch tasks as Claude sessions from the task board

Session Monitoring

Monitor active sessions while running in the terminal

Git Integration

Run git commands directly in the terminal

Build docs developers (and LLMs) love