addSubtask
Adds a subtask to a specified parent task.
LABSCO SUMMARY
The plan and the tools that change the code live in the same place, so state stays current.
Most task servers describe work and stop there; here the same session can read the code, run the tests, drive a browser and then update the task's status and activity log, which is what keeps the graph honest. The priority engine is the unusual part — time decay and effort weighting mean "what's next" moves on its own rather than reflecting the order things were entered. Set the boundaries deliberately: ALLOWED_DIRS and READONLY_MODE are the only things standing between these tools and the rest of the disk, and the browser and AppleScript families need their own prerequisites before they do anything.
What it is
An orchestration layer that combines a priority-driven task manager with the tools needed to act on it: file read and write, code search and surgical edits, terminal sessions, Playwright browser control and AppleScript. Filesystem access is bounded by an allowed-directory list and an optional read-only mode.
What you get
- Tasks and subtasks with numeric priority, dependencies, status and related files — addTask, addSubtask, listTasks, updateStatus, updateTask, removeTask, getNextTask
- getContext returns one task's full context block including related files and its activity log, and generateTaskFiles materialises a Markdown file per task plus a table overview
- A priority engine you can tune rather than guess at: recalculatePriorities, configureTimeDecay, configureEffortWeighting, getPriorityStatistics, getDependencyAnalysis, plus templates through getPriorityTemplates, suggestPriorityTemplate and addTaskWithTemplate, and quick moves with bumpTaskPriority and deferTaskPriority
- parsePrd turns a product document into tasks, expandTask breaks one open, and reviseTasks folds a change request back into the graph
- A file watcher that keeps the task files and the table in sync — initializeFileWatcher, getFileWatcherStatus, forceSyncTaskFiles
- Filesystem tools inside the allowed directories: read_file, read_multiple_files, write_file, copy_file, move_file, delete_file, create_directory, list_directory, tree, search_files, get_file_info, with list_allowed_directories and get_filesystem_status making the boundary visible
- search_code for retrieval and edit_block for surgical old-block-to-new-block replacements rather than whole-file rewrites
- Terminal orchestration: execute_command, read_output, list_sessions, force_terminate, list_processes and kill_process, with blocked commands and timeouts as guardrails
- Playwright browser control — navigate, click, type, hover, drag, select, press keys, screenshots, accessibility snapshots, PDF save, console messages, network requests, dialogs, file upload, tabs and resizing
- applescript_execute on macOS for the things only the OS can do
Requirements
No account for the core. Node.js, with the MCP server started as bin/agentic-control-framework-mcp --workspaceRoot pointing at your project; the same code also runs as the acf CLI. WORKSPACE_ROOT sets the default workspace, ALLOWED_DIRS adds directories the file tools may touch, and READONLY_MODE=true disables writes entirely. Browser tools need Playwright browsers installed (npx playwright install), and the AppleScript tool needs macOS. GEMINI_API_KEY is what enables the AI-backed planning tools — parsePrd, expandTask and reviseTasks — and nothing else depends on it.
Setup effort
Build from source — git clone https://github.com/FutureAtoms/agentic-control-framework.git
USE CASES
01
Turning a product document into a plan you can execute
Parse the document into tasks with dependencies, expand the ones that are too coarse, and generate the per-task files for review.
02
Deciding what to work on and getting the context for it
Ask for the next actionable task given dependencies and priority, then pull its context block and read the files it touches.
03
Making a change and verifying it actually works
Apply a surgical block edit, run the tests in a terminal session, read the output, and set the task's status accordingly.
04
Checking a web change looks right
Drive the page, take an accessibility snapshot or screenshot, and read the console and network activity behind it.
05
Keeping a backlog from going stale
Recalculate priorities with time decay and effort weighting, look at the dependency analysis, and reprioritise what has drifted.
06
Letting an assistant explore a repository without write access
Run with read-only mode on and the allowed directories set, so retrieval and search work and nothing can be modified.
83 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
addTask
Adds a new task to the task list.
addTaskWithTemplate
Add a new task using a priority template for automatic priority calculation.
applescript_execute
Run AppleScript code to interact with Mac applications and system features. This tool can access and manipulate data in Notes, Calendar, Contacts, Messages, Mail, Finder, Safari, and other Apple applications. Common use cases include but not limited to: - Retrieve or create notes in Apple Notes - Access or add calendar events and appointments - List contacts or modify contact details - Search for and organize files using Spotlight or Finder - Get system information like battery status, disk space, or network details - Read or organize browser bookmarks or history - Access or send emails, messages, or other communications - Read, write, or manage file contents - Execute shell commands and capture the output
browser_click
Perform click on a web page
browser_close
Close the page
browser_console_messages
Returns all console messages
browser_drag
Perform drag and drop between two elements
browser_file_upload
Upload one or multiple files
browser_handle_dialog
Handle a dialog
browser_hover
Hover over element on page
browser_install
Install the browser specified in the config
browser_navigate
Navigate to a URL
browser_navigate_back
Go back to the previous page
browser_navigate_forward
Go forward to the next page
browser_network_requests
Returns all network requests since loading the page
browser_pdf_save
Save page as PDF
browser_press_key
Press a key on the keyboard
browser_resize
Resize the browser window
browser_select_option
Select an option in a dropdown
browser_snapshot
Capture accessibility snapshot of the current page
browser_tab_close
Close a tab
browser_tab_list
List browser tabs
browser_tab_new
Open a new tab
browser_tab_select
Select a tab by index
browser_take_screenshot
Take a screenshot of the current page
browser_type
Type text into editable element
browser_wait
Wait for a specified time in seconds
browser_wait_for
Wait for text to appear or disappear or a specified time
bumpTaskPriority
Increase task priority by a specified amount.
calculatePriorityFromTemplate
Calculate priority for a task using a specific template.
configureEffortWeighting
Configure effort-weighted priority scoring based on task complexity, impact, and urgency.
configureTimeDecay
Configure time-based priority decay settings with multiple decay models.
copy_file
Copy files and directories.
create_directory
Create a new directory or ensure a directory exists.
deferTaskPriority
Decrease task priority by a specified amount.
delete_file
Delete a file or directory from the file system.
deprioritizeTask
Set task to low priority (100-400 range).
edit_block
Apply surgical text replacements to files
execute_command
Execute a terminal command with timeout
expandTask
Uses the Gemini API to break down a task into subtasks (overwrites existing subtasks).
force_terminate
Force terminate a running terminal session
forceSyncTaskFiles
Force immediate synchronization of all task-related files.
generateTaskFiles
Generates individual Markdown files for each task in the tasks/ directory.
generateTaskTable
Generates a human-readable Markdown file with task statuses and checkboxes.
get_config
Get the complete server configuration as JSON
get_file_info
Retrieve detailed metadata about a file or directory.
get_filesystem_status
Returns the current status of filesystem operations, including read-only mode and allowed directories.
getAdvancedAlgorithmConfig
Get current configuration for all advanced priority algorithms including time decay and effort weighting.
getContext
Retrieves detailed context for a specific task or subtask.
getDependencyAnalysis
Get comprehensive dependency analysis including critical paths, blocking tasks, and circular dependencies.
getFileWatcherStatus
Get current file watcher status, statistics, and configuration.
getNextTask
Gets the next actionable task based on status, dependencies, and priority.
getPriorityStatistics
Get priority statistics for all tasks including distribution and utilization.
getPriorityTemplates
Get all available priority templates for common task types.
initializeFileWatcher
Initialize automatic file synchronization watcher for tasks.json changes.
initProject
Initializes the task manager project.
kill_process
Terminate a running process by PID
list_allowed_directories
Returns the list of directories that this server is allowed to access.
list_directory
Get a detailed listing of all files and directories in a specified path.
list_processes
List all running processes
list_sessions
List all active terminal sessions
listTasks
Lists tasks, optionally filtered by status.
move_file
Move or rename files and directories.
parsePrd
Parses a Product Requirements Document (PRD) file using the Gemini API to generate tasks.
prioritizeTask
Set task to high priority (800-900 range).
read_file
Read the complete contents of a file from the file system or from a URL.
read_multiple_files
Read the contents of multiple files in a single operation.
read_output
Read new output from a running terminal session
recalculatePriorities
Recalculate all task priorities using advanced algorithms including dependency boosts and distribution optimization.
removeTask
Removes a task or subtask by its ID.
reviseTasks
Uses the Gemini API to revise future tasks based on a prompt/change, starting from a specific task ID.
search_code
Search for text/code patterns within file contents using ripgrep
search_files
Recursively search for files and directories matching a pattern.
set_config_value
Set a specific configuration value by key
setWorkspace
Sets the workspace directory for the task manager.
stopFileWatcher
Stop the automatic file synchronization watcher.
suggestPriorityTemplate
Suggest the best priority template for a task based on title and description.
tree
Returns a hierarchical JSON representation of a directory structure.
updateStatus
Updates the status of a task or subtask.
updateSubtask
Updates the details of a subtask (e.g., title).
updateTask
Updates the details of a task (title, description, priority, etc.). Does not update status.
write_file
Create a new file or overwrite an existing file with new content.
BEFORE YOU INSTALL
What to know first
Tools you get
83 tools when we connected. The documentation's tool map says 79, but 83 register. read_url, described in its Security section, is not an available tool.
Requires
- npx on PATH
- Node.js 18+
Where it runs
All 4 documented clients run the server on your machine.
CONTEXT COST
Moderate Standing cost
Rated by the size of the 83 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/FutureAtoms/agentic-control-framework.git
cd agentic-control-framework
npm install
chmod +x bin/*MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"agentic-control-framework": {
"command": "<YOUR_ACF_PATH>/bin/agentic-control-framework-mcp",
"env": {
"ACF_PATH": "<YOUR_ACF_PATH>",
"WORKSPACE_ROOT": "<YOUR_WORKSPACE_ROOT>",
"ALLOWED_DIRS": "<YOUR_WORKSPACE_ROOT>:/tmp",
"READONLY_MODE": "false",
"BROWSER_HEADLESS": "false",
"DEFAULT_SHELL": "/bin/bash"
}
}
}
}Claude Code
CLAUDE CODE · JSON
{
"mcpServers": {
"agentic-control-framework": {
"type": "stdio",
"command": "node",
"args": [
"<YOUR_ACF_PATH>/bin/agentic-control-framework-mcp",
"--workspaceRoot",
"<YOUR_WORKSPACE_ROOT>"
],
"env": {
"ACF_PATH": "<YOUR_ACF_PATH>",
"WORKSPACE_ROOT": "<YOUR_WORKSPACE_ROOT>",
"READONLY_MODE": "false",
"BROWSER_HEADLESS": "false",
"DEFAULT_SHELL": "/bin/bash",
"NODE_ENV": "production"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"acf-local": {
"command": "node",
"args": [
"<YOUR_ACF_PATH>/bin/agentic-control-framework-mcp",
"--workspaceRoot",
"<YOUR_WORKSPACE_ROOT>"
],
"env": {
"WORKSPACE_ROOT": "<YOUR_WORKSPACE_ROOT>",
"ALLOWED_DIRS": "<YOUR_WORKSPACE_ROOT>:/tmp",
"READONLY_MODE": "false"
}
}
}
}Cursor
CURSOR · JSON
{
"mcpServers": {
"acf-local": {
"command": "node",
"args": [
"<YOUR_ACF_PATH>/bin/agentic-control-framework-mcp",
"--workspaceRoot",
"<YOUR_WORKSPACE_ROOT>"
],
"env": {
"WORKSPACE_ROOT": "<YOUR_WORKSPACE_ROOT>",
"ALLOWED_DIRS": "<YOUR_WORKSPACE_ROOT>:/tmp",
"READONLY_MODE": "false"
}
}
}
}
