Core Concepts
Agent
Agent
The main AI assistant that processes requests and executes tools
Context Exhaustion
Context Exhaustion
When conversation history fills context window, limiting the ability to reference earlier content
Context Remaining
Context Remaining
Indicator in the middle panel showing how much model context is left for the current conversation
Context Window
Context Window
Amount of conversation history the AI can reference
MCP (Model Context Protocol)
MCP (Model Context Protocol)
System for extending Verdent with external tools
Project
Project
A git repository you’re actively working on. Projects maintain independent session history and configuration.
Subagent
Subagent
Specialized AI agent with isolated context for specific tasks (e.g., Verifier)
Task
Task
A specific piece of work within a workspace. Tasks represent individual conversation threads and share the workspace file state.
Tool
Tool
Function the agent can execute (file_read, bash, glob, etc.)
Execution Modes
Agent Mode
Agent Mode
Full autonomous execution mode where Verdent can read, write, and execute commands without additional approval steps. Default mode for active development.
Plan Mode
Plan Mode
Read-only planning mode where Verdent analyzes and creates implementation plans without making file modifications. Best for complex changes and unfamiliar codebases.
Desktop-Specific Terms
Base Workspace
Base Workspace
The primary working directory on your chosen branch. Reference point for creating new worktrees, where rebased work ends up.
Git Worktree
Git Worktree
Isolated working directory linked to the same repository, enabling parallel development without file conflicts
Parallel Agents
Parallel Agents
Multiple AI agents working simultaneously in separate worktrees, each with isolated context
Project Switching
Project Switching
Rapid navigation between different projects while maintaining session state
Rebase to main branch
Rebase to main branch
Process of applying changes from a workspace back into the main branch (the branch the workspace was created from)
Sync with main branch
Sync with main branch
Pull latest changes from the main branch into the current workspace
In “Rebase to main” and “Sync from main,” the branch name shown is actually the branch of the current Base Workspace, not necessarily
master. If your Base Workspace is on a different branch (e.g., develop), the actions will target that branch instead.Task Worktree
Task Worktree
Isolated directory for a specific task with a complete copy of repository files and a separate branch
Files & Configuration
AGENTS.md
AGENTS.md
Project-specific team standards file (project root, version controlled)
mcp.json
mcp.json
MCP server configuration (
~/.verdent/mcp.json)VERDENT.md
VERDENT.md
Global personal preferences file (
~/.verdent/VERDENT.md)Workspace
Workspace
A git worktree - an isolated working directory linked to the same repository, enabling parallel development
Tool-Specific Terms
Glob Pattern
Glob Pattern
File search pattern using wildcards (
**/*.ts, src/**/*.js)Line Range
Line Range
Specific lines to read from large files (start_line, max_lines)
Regex
Regex
Regular expression for advanced text searching
Replace All
Replace All
file_edit flag to replace multiple identical strings
Timeout
Timeout
Maximum time for bash commands: 120 seconds (2 minutes, hard limit)
Subagent Terms
Flexible Policy
Flexible Policy
Subagent can activate automatically based on request patterns
Isolated Context
Isolated Context
Subagent’s separate context window (doesn’t consume main context)
Strict Policy
Strict Policy
Subagent only runs when explicitly @-mentioned
System Prompt
System Prompt
Instructions defining subagent’s behavior and expertise
MCP Terms
Global Config
Global Config
User-wide MCP configuration (
~/.verdent/mcp.json)MCP Server
MCP Server
External tool/service integrated via Model Context Protocol
Plugin
Plugin
Pre-built MCP integration for specific tools or services
Performance Terms
Delegation
Delegation
Routing tasks to subagents to preserve main context
Parallel Execution
Parallel Execution
Multiple subagents running simultaneously
Strategic Reading
Strategic Reading
Using line ranges and search to minimize context usage
Task Coordination
Task Coordination
Main agent managing multiple subagent operations