C
Docs

File Browser & Editor

Browse, view, and edit your project files directly from your phone.

Overview

C3 includes a built-in file browser and editor, giving you direct access to your project files. No need to switch apps — browse your codebase, view file contents, and make quick edits right from your mobile device.

The file browser is perfect for:

  • Reviewing code that the agent is working with
  • Making quick manual edits
  • Navigating project structure
  • Uploading and downloading files
  • Creating new files and folders

Accessing the File Browser

Open the file browser from the Projects screen:

  1. Go to the Projects tab
  2. Tap the folder icon on a project card
  3. The file browser opens at your project's root directory

Server Connection Required

The file browser requires an active connection to your C3 backend. Make sure the server is running and your device is connected.

Browsing Files

Navigation

  • Tap a folder — Open the folder to see its contents
  • Tap a file — Open the file in the viewer/editor
  • Breadcrumb bar — Tap any segment to jump to that directory
  • Back button — Return to the parent directory
  • Pull down — Refresh the current directory listing

File Information

Each item in the browser shows:

  • File or folder icon based on type
  • Name
  • File size (for files)

Worktree Support

If your project has Git Worktrees enabled, you'll see a toggle button in the header:

  • Tap the branch icon to switch between main and worktree views
  • A banner indicates which view you're currently browsing
  • File operations apply to the currently active view

File Operations

Creating Files and Folders

  1. Tap the + button (floating action button) in the bottom right
  2. Select "New" from the menu
  3. Enter a name for your file or folder
  4. Tap Create to confirm

Uploading Files

  1. Tap the + button in the bottom right
  2. Select "Upload" from the menu
  3. Choose a file from your device (up to 50MB)
  4. The file is uploaded to the current directory with progress indication

Downloading Files

  1. Long-press on a file, or tap the menu icon on the file row
  2. Select "Download File"
  3. The file is saved to your Downloads folder
  4. A share dialog appears to open or share the file

Deleting Files and Folders

There are two ways to delete items:

  • Swipe right on a file or folder to reveal the delete button
  • Long-press and select "Delete" from the menu

A confirmation dialog appears before deletion.

Other Actions

Long-press on a file to access additional options:

  • Insert Path — Insert the file path into your chat message
  • Copy Path — Copy the full path to clipboard

Insert Path

Use "Insert Path" to quickly reference files in your conversation with the agent. The full path is added to your message input.

Viewing Files

Tap any file to open it in the viewer:

Code Files

Code and text files display with:

  • Syntax highlighting based on file type
  • Line numbers along the left side
  • Horizontal scrolling for long lines
  • Light or dark theme based on app settings

Supported Languages

Syntax highlighting supports 40+ languages including:

  • JavaScript, TypeScript, JSX, TSX
  • Python, Ruby, PHP, Go, Rust
  • Java, Kotlin, Swift, Dart
  • HTML, CSS, SCSS, Less
  • JSON, YAML, XML, GraphQL
  • Shell, Bash, Zsh
  • SQL, Markdown, and more

Language Selection

The language is auto-detected from the file extension. To manually change it:

  1. Tap the language indicator in the header
  2. Select the correct language from the picker

File Information

The editor header shows:

  • File name and path
  • Line count
  • File size in bytes

Large Files

Files with more than 5,000 lines show a warning banner. Large files are loaded in chunks with a progress indicator to prevent performance issues.

Editing Files

Switching to Edit Mode

  1. Open a file in the viewer
  2. Tap the edit icon (pencil) in the header
  3. The view switches to edit mode with a text input

Edit Mode Features

  • Full text editing with your mobile keyboard
  • Monospace font for code editing
  • Auto-capitalization and spell-check disabled
  • Unsaved changes indicator in the header

Saving Changes

  1. Make your edits in the text area
  2. Tap the Save button in the header
  3. A progress bar shows during save for large files
  4. The editor returns to view mode after saving

Discarding Changes

If you have unsaved changes and try to navigate away:

  • A prompt asks if you want to discard changes
  • Choose to save, discard, or cancel navigation

Manual Edits and the Agent

Files you edit manually aren't automatically tracked by the agent's context. If you make changes while the agent is working, mention it in the chat so the agent can re-read the updated file.

Edit Mode Limitations

Edit mode provides plain text editing without syntax highlighting. For complex refactoring, consider asking the agent to make the changes instead.