Q&A: File System, Workspace & Project Management — How the Agent Navigates Your Codebase

[AGI-Corporation]

File System, Workspace & Project Management Deep-Dive Q&A

This thread covers how CactusRalph-Coder interacts with your file system and project workspace — reading, writing, navigating codebases, managing project context, and staying oriented in large repos.

---

Common Questions

Workspace setup & project context

• How do I point the agent at a specific project directory or repository?
• How does the agent build an understanding of my project structure on first run?
• Can the agent read a README.md or project manifest to understand the project before starting?
• How do I scope the agent to only work within certain subdirectories?

File reading & writing

• What file types can the agent read (source code, configs, docs, CSVs)?
• How does the agent decide which files to read when working on a task?
• How are file writes handled — does the agent write directly or stage changes for review?
• Is there a diff preview before the agent overwrites a file?

Large codebase handling

• How does the agent handle very large repositories (10k+ files)?
• Does the agent index the codebase? What kind of index is built?
• How does semantic search over the codebase work (symbol lookup, function search)?
• How do I tell the agent to ignore certain directories (e.g., node_modules, __pycache__, dist)?

Git integration

• Does the agent understand git history (blame, log, diff)?
• Can the agent create commits or branches automatically?
• How do I configure the agent to work on a feature branch and open a PR?
• Can the agent resolve merge conflicts?

Project memory across sessions

• How does the agent remember project-specific context from a previous session?
• Can I define persistent project notes or constraints in a config file?
• Is there a .cactusralph or similar config file for per-project settings?

Multi-repo & monorepo

• How does the agent handle monorepos with multiple packages?
• Can the agent navigate between packages and understand cross-package dependencies?
• How do I configure workspace boundaries in a Nx, Turborepo, or pnpm workspace?

---

Share your project setup patterns, .gitignore-style config tips, and codebase navigation tricks below.