ccg_runLABSCO SUMMARY
For repositories where the agent needs a map before it starts editing.
The centre of this server is the hotspot pass: scan, score, rank, and only then plan a change. What makes it worth wiring up over a plain analyser is everything around that loop — guard rules that reject fake tests, a session store that lets the same refactor continue in tomorrow's conversation, and a task list that lives in the project rather than in the chat.
What it is
Code Guardian Studio (CCG), a refactoring workbench for a coding agent working on a repository too big to hold in one context. It maps the codebase, scores files by complexity, writes the refactor plan, and remembers where you left off. Version 4.1.0, MIT open-core.
What you get
- A repository map and a ranked list of what to fix first —
code_scan_repository,code_metrics,code_hotspots, orcode_quick_analysisfor all three in one call - A step-by-step plan and a Markdown report you can hand to a human:
code_refactor_plan,code_generate_report - Guard rules that block dangerous patterns such as fake tests and empty catch blocks —
guard_validate,guard_rules,guard_toggle_rule,guard_check_test - Work that survives the end of a conversation:
session_save,session_resume,session_timeline,session_replay, plusmemory_storeandmemory_recall - Task tracking inside the repo —
workflow_task_create,workflow_task_start,workflow_task_complete,workflow_task_list, and progress views viaprogress_statusandprogress_blockers - Semantic code search over an index you build once:
rag_build_index,rag_query,rag_related_code - Test and browser runs wired in —
testing_run,testing_run_affected,testing_browser_open,testing_browser_errors,testing_browser_network - One natural-language entry point,
ccg_run, which translates a prompt into a tool sequence and can return the plan without executing it - 173 tools in the project's tools reference, grouped into agents, AST, guard, latent chain, memory, process, profile, RAG, resource, session, testing, thinking and workflow families
Requirements
Node.js 18.0.0+ and npm 8.0.0+, and the npm package codeguardian-studio — installed globally, or launched with npx. CCG_PROJECT_ROOT is the one required environment variable and must point at your project root; CCG_LOG_LEVEL and CCG_LICENSE_KEY are optional. Running ccg init inside the project writes the client configuration for you. The bundled better-sqlite3 native module compiles at install time, so a build toolchain has to be present: Xcode Command Line Tools on macOS, build-essential and python3 on Debian and Ubuntu, Visual Studio Build Tools on Windows. The Dev plan is free and fully offline; the Team plan is $19/month and validates its licence against api.codeguardian.studio.
Setup effort
One command — npm install -g codeguardian-studio
USE CASES
01
Deciding where to start on a codebase you inherited
One call maps the repository, computes complexity and nesting scores, and returns the files that need attention first. The report goes out as Markdown.
02
Picking up a refactor that spans several sittings
Resume the saved session, read back the timeline of what was already changed, and continue against the same task list.
03
Stopping a test that tests nothing
Validate the change against the guard rules before it lands, and check the test itself rather than only its result.
04
Finding the code a change will touch
Build the semantic index once, then query it by intent instead of by filename, and pull neighbouring code.
173 tools
Listed in project docs. Your client may show a different list.
agents_coordinateagents_getagents_listagents_registeragents_reloadagents_selectagents_statusauto_agent_statusauto_analyze_complexityauto_analyze_graphauto_complete_nodeauto_create_graphauto_decompose_taskauto_delete_graphauto_fail_nodeauto_fix_loopauto_fix_statusauto_get_next_nodesauto_graph_statusauto_list_graphsauto_recall_errorsauto_route_toolsauto_run_graphauto_start_nodeauto_store_errorauto_workflow_executeauto_workflow_mermaidauto_workflow_startauto_workflow_template_getauto_workflow_template_listcode_generate_reportcode_hotspotscode_metricscode_optimizer_statuscode_quick_analysiscode_record_optimizationcode_refactor_plancode_scan_repositorydocuments_createdocuments_find_by_typedocuments_listdocuments_registerdocuments_scandocuments_searchdocuments_should_updatedocuments_statusdocuments_updateguard_check_testguard_rulesguard_statusguard_toggle_ruleguard_validatelatent_apply_patchlatent_complete_tasklatent_context_createlatent_context_getlatent_context_updatelatent_delete_contextlatent_diff_applylatent_diff_configlatent_diff_confirmlatent_diff_pendinglatent_diff_rollbacklatent_list_contextslatent_phase_transitionlatent_statuslatent_step_loglatent_validate_responsememory_forgetmemory_listmemory_recallmemory_storememory_summaryast_dependenciesast_detect_languageast_parseast_statusast_symbolscheck_all_portscheck_portcheck_testkill_on_portonboarding_autofixonboarding_initonboarding_migrateonboarding_statusonboarding_validateonboarding_welcomeprogress_blockersprogress_clearprogress_mermaidprogress_statusstride_analyzestride_analyze_filesstride_categoriesstride_checkliststride_threatstoggle_ruleprocess_check_all_portsprocess_check_portprocess_cleanupprocess_killprocess_kill_on_portprocess_listprocess_spawnprocess_statusprofile_createprofile_deleteprofile_detectprofile_getprofile_listprofile_statusprofile_switchprofile_updaterag_build_indexrag_clear_indexrag_get_chunkrag_queryrag_related_coderag_statusresource_action_allowedresource_checkpoint_createresource_checkpoint_deleteresource_checkpoint_diffresource_checkpoint_listresource_checkpoint_restoreresource_estimate_taskresource_governor_stateresource_statusresource_update_tokenssession_endsession_exportsession_initsession_offersession_replaysession_resumesession_savesession_statussession_timelinetesting_browser_analysistesting_browser_closetesting_browser_errorstesting_browser_logstesting_browser_networktesting_browser_opentesting_browser_screenshottesting_cleanuptesting_runtesting_run_affectedtesting_statusthinking_get_modelthinking_get_stylethinking_get_workflowthinking_list_modelsthinking_list_snippetsthinking_list_workflowsthinking_save_snippetthinking_statusthinking_suggest_modelthinking_suggest_workflowworkflow_cleanupworkflow_currentworkflow_statusworkflow_task_completeworkflow_task_createworkflow_task_deleteworkflow_task_failworkflow_task_listworkflow_task_noteworkflow_task_pauseworkflow_task_startworkflow_task_updateBEFORE YOU INSTALL
What to know first
Tools you get
173 tools named in the project's documentation.
Requires
npm on PATH
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g codeguardian-studioMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"code-guardian": {
"command": "npx",
"args": [
"-y",
"codeguardian-studio"
],
"env": {
"CCG_PROJECT_ROOT": "<YOUR_CCG_PROJECT_ROOT>"
}
}
}
}Claude Code
CLAUDE CODE · TERMINAL
ccg init
