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:
- Go to the Projects tab
- Tap the folder icon on a project card
- 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
- Tap the + button (floating action button) in the bottom right
- Select "New" from the menu
- Enter a name for your file or folder
- Tap Create to confirm
Uploading Files
- Tap the + button in the bottom right
- Select "Upload" from the menu
- Choose a file from your device (up to 50MB)
- The file is uploaded to the current directory with progress indication
Downloading Files
- Long-press on a file, or tap the menu icon on the file row
- Select "Download File"
- The file is saved to your Downloads folder
- 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:
- Tap the language indicator in the header
- 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
- Open a file in the viewer
- Tap the edit icon (pencil) in the header
- 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
- Make your edits in the text area
- Tap the Save button in the header
- A progress bar shows during save for large files
- 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.