pi ABAP FS

ABAP remote filesystem access for the pi coding agent.

Gives the pi agent live, read/write access to an SAP S/4HANA system over the ADT (ABAP Development Tools) protocol — search and read real objects, edit and activate source code, run unit tests and ATC, analyze dumps and performance traces, and query live tables, all through plain-language prompts. No VS Code or IDE required.

Built on abap-adt-api, a standalone Node.js client for the ADT REST interface.

Requirements

• pi coding agent (Node 26+)
• An SAP system with ADT (ABAP Development Tools) enabled
  • Reading/browsing works on NetWeaver 7.51+; writing on older systems may need the abapfs_extensions plugin (see upstream docs).

Installation

pi install npm:@patimweb/pi-abap-fs

or run directly for a quick test:

pi -e ./index.ts

Setup

1. Ask pi to configure a connection, or call the tool directly:

   Use abap_setup to configure my dev system:
   name=dev, url=http://vhcalnplci.bti.local:8000,
   username=DEVELOPER, password=..., client=001

   Credentials are stored in ~/.pi/abap-config.json (mode 0600, owner-readable only).

2. Verify the connection:

   Use abap_test_connection to check the dev profile.

Tools

| Tool | Purpose | |------|---------| | abap_setup | Configure an SAP connection profile | | abap_status | Show configured profiles and the active one | | abap_profile | List / switch / delete profiles | | abap_test_connection | Verify a profile can log on | | abap_search | Search objects by name pattern | | abap_object_structure | Object metadata and include list | | abap_read | Read an object's source code | | abap_lock / abap_unlock | Lock management | | abap_write | Write source code (lock → write → unlock) | | abap_activate | Activate an object | | abap_syntax_check | Syntax-check source | | abap_unit_test | Run ABAP unit tests | | abap_query | Run an ABAP SQL query | | abap_table | Preview table/view contents | | abap_where_used | Where-used list | | abap_object_types | List searchable object types | | abap_node_contents | Browse a package's object tree | | abap_transports | List transport requests | | abap_atc | Run ATC analysis on an object | | abap_dumps | List runtime dumps | | abap_traces | List performance traces | | abap_trace_hitlist | Analyze a performance trace | | abap_transport_details | Details of one transport request | | abap_text_elements | Read text elements (symbols/selections/headings) | | abap_set_text_elements | Write text elements | | abap_create_object | Create a new ABAP object |

Example prompts

• "How does ZCL_MY_CLASS work?" — the agent searches, reads the source and related objects.
• "Find all classes with 'pricing' in the name."
• "Add method calculate to ZCL_MY_CLASS and activate it."
• "Run the unit tests for ZCL_MY_CLASS and explain the failures."
• "Show me the first 20 rows of table SFLIGHT where CARRID = 'LH'."
• "Run ATC on ZCL_MY_CLASS and summarize the findings."
• "Are there any recent runtime dumps in the system?"
• "List my open transport requests, then show the objects in DEVK900123."
• "Analyze the latest performance trace and find the hot spots."
• "Create a new class ZCL_ORDER_HELPER in package Z_MY_PACKAGE."
• "Read the text symbols of report Z_MY_REPORT."

Development

npm install
npm run typecheck   # tsc --noEmit
npm test            # node --test over tests/**/*.test.ts

The extension is TypeScript loaded directly by pi (via jiti) — no build step.

Release

Releases use semantic-release on the main (and next) branches. Commits follow Conventional Commits; CI runs the test suite, and the release workflow publishes to npm on merge.

License

MIT