v8-runner CLI
A Rust CLI and MCP server for the local 1C development loop: builds, syntax checks, YAxUnit and Vanessa tests, dumping changes
- 63 ★ on the repository
- Last commit
- AGPL-3.0
Extended access
Why this level
- Runs the 1C platform and loads configurations into infobases
- Stores infobase credentials in a local file
Install
- Works in
- Services
Manual install
cargo build --releaseBuild from source, the binary lands in target/release/v8-runner.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs the 1C platform and loads configurations into infobases
- Stores infobase credentials in a local file
This is third-party code. Review the repository files before installing.
What it does
v8-runner replaces a pile of scripts and manual Designer, EDT and Vanessa Automation runs with one entry point. A single v8project.yaml describes sources, the working infobase, tools and tests, and config init or bootstrap creates it from the repository layout or an existing infobase. It then offers incremental builds, module syntax checks, YAxUnit and Vanessa Automation runs, dumping, converting and loading cf, cfe, epf and erf files, and launching 1C clients. For agents there is an MCP server over stdio or HTTP with a narrow tool set, plus machine-readable --json-message output.
Who it is for. For 1C developers and teams who need a repeatable local build and test loop for themselves, CI and agents.
Good fit when
- You want the agent to build the project, check syntax and run tests on its own
- You want to replace scattered bat scripts with one config and command set
- You want YAxUnit or Vanessa Automation to run with one command after a build
Not a fit when
- The machine has no 1C platform or EDT
- You need to work with a server infobase in production
Example request
Build the project, check server module syntax and run all YAxUnit testsLimitations
Requires an installed 1C platform, and EDT for EDT projects. AGPL-3.0 license. Some features depend on the build backend: not every operation works through IBCMD. There is no separate connection preflight for server infobases yet.
How to disable. Delete the v8-runner binary and the server block from your MCP client config. v8project.yaml and v8project.local.yaml in the project can be removed manually.
FAQ
Are EDT projects supported?
Yes, source sets can be DESIGNER or EDT format, and init imports the workspace for EDT.
Where do infobase passwords go?
Into v8project.local.yaml next to the main config. That file is added to .gitignore automatically.
Discussion
No questions or reviews yet.
Related
All 1C:Enterprise tools1C AI development environment
1C AI Development Environment
1C development environment with an MCP server offering 10 tools: 11 BSL analyzers, JSON DSL to XML, dependency graph, and EPF build without 1C
A local read-only MCP server suite for 1C: a Rust code indexer, metadata skills, a prompt gallery and platform help search, with evidence-backed answers
Gyrfalcon: 1C code navigation MCP
gyrfalcon
A single dependency-free Rust binary with no network calls: indexes a 1C configuration export and answers call-graph and metadata questions in milliseconds
A set of skills, rules and MCP servers for 1C Enterprise 8.3 development where the agent works from real code and docs, not from memory
1C AI sandbox client-server
1c-ai-sandbox-client-server
A devcontainer plus a Hyper-V VM with a 1C server that isolate an AI agent from the host machine so a wrong command cannot touch real files or drives
78 MCP tools for 1C development over local XML exports: metadata, code audit, queries, EPF, configuration diffing, and a verified API reference
README in short
The README presents v8-runner as a single entry point for local 1C development and walks through a quick start: building the binary, creating the config, downloading YAxUnit, Vanessa and client MCP, preparing the infobase, building, syntax checks and tests. A capability table groups commands into project setup, verification, file materialization, direct launch and MCP. The repository also ships a SKILL for Codex and detailed configuration and architecture docs. AGPL-3.0 license.