File Explorer
Browse project files with syntax highlighting—no IDE needed.
AgentOS includes a file explorer so you can browse and view code without leaving the app.
Opening File Explorer
From any session, click the Files tab in the pane header to switch from terminal to file explorer.
The explorer shows files in the session's working directory.
Navigation
Directory Tree
- Tap folder to expand/collapse
- Tap file to view contents
- Nested folders indent for visual hierarchy
Breadcrumb Path
The current path shows at the top. Tap any segment to navigate up the tree.
Viewing Files
Tap a file to view its contents with:
- Syntax highlighting for 100+ languages
- Line numbers for easy reference
- Monospace font for proper alignment
Supported File Types
| Category | Extensions |
|---|---|
| JavaScript | .js, .jsx, .ts, .tsx |
| Python | .py |
| Go | .go |
| Rust | .rs |
| Ruby | .rb |
| Java | .java |
| C/C++ | .c, .cpp, .h |
| Web | .html, .css, .scss |
| Config | .json, .yaml, .toml |
| Markdown | .md, .mdx |
| Shell | .sh, .bash, .zsh |
Binary Files
Binary files (images, compiled code, etc.) are detected and skipped. You'll see a message instead of garbled content.
Read-Only Viewing
The file explorer is read-only. To edit files, use your AI agent in the terminal:
Edit the function in src/utils.ts to add error handling
This design keeps the mobile UI simple while your AI assistant handles the editing.
Use Cases
Code Review
Review changes your AI agent made:
- Check the git panel to see what files changed
- Open file explorer to see the full file context
- Navigate between files to understand the changes
Understanding Codebases
Explore unfamiliar projects:
- Browse the directory structure
- Read key files like
README.md,package.json - Navigate to source directories to understand architecture
Quick Reference
Look up code while chatting with your AI:
What does the handleAuth function in src/auth.ts do?
Open the file to see it while discussing with your agent.
Mobile Optimizations
Touch-Friendly
- Large tap targets for folders and files
- Smooth scrolling through long files
- Pull-to-refresh to reload directory
Single-Pane View
On mobile, the file explorer takes the full screen. Use the bottom tabs to switch between:
- Terminal
- Files
- Git
Fits Narrow Screens
Code wraps intelligently and line numbers stay visible even on phone screens.
Directory Picker
When creating a session or changing working directory, you'll use the Directory Picker:
- Start at your home directory (or last used location)
- Tap folders to navigate deeper
- Tap Select when you reach your target
- Or tap New Folder to create one
The picker remembers your most-used directories for quick access.