APS-Code

AI engineering power for work that has to hold up.

APS-Code is the AI software-engineering workspace from American Power Systems. It brings the same priorities APS applies to critical power work—safety, quality, reliability, teamwork, and disciplined execution—into the developer workflow.

Johnny 5 works alongside your team in VS Code to understand a codebase, plan changes, write and review code, run tools, diagnose failures, and carry complex work through to a verified result.

AI provider

APS-Code supports Cloudflare Workers AI as its only user-configurable AI provider. Setup requires a Cloudflare Account ID and API token, with an optional AI Gateway ID. The default model is @cf/qwen/qwen2.5-coder-32b-instruct.

Legacy provider schemas and runtime adapters remain in the source only where they support inexpensive profile migration or shared streaming, message transformation, tool-call, and model infrastructure. They are not exposed in the APS-Code settings or onboarding UI.

Engineered the APS way

• Safety before speed — Destructive Command Guard, explicit approvals, checkpoints, and change review help protect the workspace while Johnny 5 works.
• Operational reliability — dependable terminal execution, task recovery, context management, and isolated per-mode model settings support longer, steadier runs.
• Engineering depth — Semble semantic search gives Johnny 5 fast, on-demand understanding of large codebases without a separate indexing workflow.
• Team execution — Code, Architect, Ask, Debug, Orchestrator, and custom modes divide complex work into focused responsibilities.
• APS-controlled AI — first-class Cloudflare Workers AI and optional AI Gateway configuration keep the deployment aligned with APS infrastructure choices.
• Verified outcomes — APS-Code is designed around implementation, validation, and review—not just code generation.

Put Johnny 5 to work

• Turn requirements and field knowledge into working software
• Plan architecture, migrations, and operational changes
• Refactor and debug existing systems
• Write tests, documentation, and release-ready implementation notes
• Automate repetitive engineering work with tools and MCP servers
• Review changes and validate the result before handoff

Modes

APS-Code adapts to the job at hand:

• Code Mode: everyday coding, edits, and file ops
• Architect Mode: plan systems, specs, and migrations
• Ask Mode: fast answers, explanations, and docs
• Debug Mode: trace issues, add logs, isolate root causes
• Custom Modes: build specialized modes for your team or workflow

Resources

• American Power Systems: Learn about APS, its nationwide critical-power services, and its commitment to safety and quality.
• Repository: Source, setup instructions, and project documentation.
• GitHub Issues: Report bugs and track development.
• Feature Requests: Have an idea? Share it with the developers.

Local Setup & Development

1. Clone the repo:

git clone https://github.com/American-Power-Systems/APS-Code.git

2. Install dependencies:

pnpm install

3. Run the extension:

There are several ways to run the APS-Code extension:

Development Mode (F5)

For active development, use VSCode's built-in debugging:

Press F5 (or go to Run → Start Debugging) in VSCode. This will open a new VSCode window with the APS-Code extension running.

• Changes to the webview will appear immediately.
• Changes to the core extension will also hot reload automatically.

Automated VSIX Installation

To build and install the extension as a VSIX package directly into VSCode:

pnpm install:vsix [-y] [--editor=<command>]

This command will:

• Ask which editor command to use (code/cursor/code-insiders) - defaults to 'code'
• Uninstall any existing version of the extension.
• Build the latest VSIX package.
• Install the newly built VSIX.
• Prompt you to restart VS Code for changes to take effect.

Options:

• -y: Skip all confirmation prompts and use defaults
• --editor=<command>: Specify the editor command (e.g., --editor=cursor or --editor=code-insiders)

Manual VSIX Installation

If you prefer to install the VSIX package manually:

1. First, build the VSIX package:

   pnpm vsix
   

2. A .vsix file will be generated in the bin/ directory (e.g., bin/aps-code-<version>.vsix).
3. Install it manually using the VSCode CLI:

   code --install-extension bin/aps-code-<version>.vsix
   

We use changesets for versioning and publishing. Check our CHANGELOG.md for release notes.

Disclaimer

Please note that APS-Code does not make any representations or warranties regarding any code, models, or other tools provided or made available in connection with APS-Code, any associated third-party tools, or any resulting outputs. You assume all risks associated with the use of any such tools or outputs; such tools are provided on an "AS IS" and "AS AVAILABLE" basis. Such risks may include, without limitation, intellectual property infringement, cyber vulnerabilities or attacks, bias, inaccuracies, errors, defects, viruses, downtime, property loss or damage, and/or personal injury. You are solely responsible for your use of any such tools or outputs (including, without limitation, the legality, appropriateness, and results thereof).

Contributing

APS-Code is improved through disciplined, reviewed contributions. Get started by reading our CONTRIBUTING.md.

License

Apache 2.0

Provenance

APS-Code is an American Power Systems product derived from the Roo Code and Zoo Code projects. APS-Code preserves required upstream license and copyright notices; upstream names describe provenance and compatibility only, not the current product.

Power the work with APS-Code. For product questions or feature ideas, open an issue.