PLEASE NOTE: This repo is being archived - the forked repository at github.com/ot4i/ace-flowpilot is now being used for the purpose of IBM authored skills for AI Agents

ace-flowpilot

This repository provides skill guidance for IBM App Connect Enterprise (ACE) Toolkit users. It combines:

• setup instructions for running the ace-flowpilot skill inside ACE Toolkit
• focused skills for creating and explaining ACE artifacts
• shared ACE reference material for projects, node types, policies, ESQL, and JavaCompute

Who this repository is for

Use this repository if you want your AI Agent (such as IBM Bob Shell or GitHub Copilot) to help with ACE Toolkit assets such as:

• message flows (.msgflow)
• ESQL (.esql)
• JavaCompute classes (.java)
• connector-based flows and related policy files

Quick start

1. Install your AI Agent (such as IBM Bob Shell or GitHub Copilot)
2. Configure ACE Toolkit to launch IBM Bob Shell in your Eclipse workspace.
3. Clone this repository into the .bob folder in that workspace
4. Use the skills under skills/ as the canonical ACE guidance.

What this repository provides

• ACE Toolkit setup guidance
• focused ACE skills under skills/
• shared ACE guidance under skills/shared/
• connector-specific guidance under skills/shared/connectors/
• legacy root-level compatibility stubs for earlier connector file paths

Installing IBM Bob Shell

The ACE Toolkit runs on Windows, Linux, or macOS. You can find detailed instructions for installing IBM Bob Shell on each of these platforms here. Focusing on Windows, you can open PowerShell and install IBM Bob Shell using this command:

irm -Uri "https://bob.ibm.com/download/bobshell.ps1" | iex

Running IBM Bob Shell in ACE Toolkit

1. Start the ACE Toolkit and from the Toolkit’s Window menu choose Preferences. When the Preferences pop-up opens navigate to the section Terminal > Local Terminal and click the Add button on the right-hand side of the window:

2. In the resulting dialog provide the following details and then click the Add button:

   • Name = IBM Bob Shell
   • Path = C:\Users\YourUserName\AppData\Roaming\npm\Bob.cmd

3. Control will return to the previous Preferences window. From the drop-down menu change the Initial Working Directory to Eclipse workspace and then click the Apply and Close button.

4. From the Window menu, choose Preferences again. When the Preferences window opens, use the filter to navigate to the section Terminal. From the Presets drop-down, select Eclipse Dark and click the Apply and Close button: