saptools

Use when indexing, linking, tracing, graphing, inspecting, diagnosing, cleaning, testing, or changing SAP CAP service-to-service flows with the service-flow CLI or @saptools/service-flow package, especially for multi-repository workspaces, SQLite state, handler implementation selection, runtime placeholders, dynamic targets, parser/linker evidence, and deterministic validation.

Use when a task involves running SQL, inspecting saved query refs, or discovering schemas, tables, and columns in SAP HANA Cloud databases bound to SAP BTP Cloud Foundry apps through the cf-hana CLI. Covers selector/app targeting, binding choice, read-only SELECT workflows, explicit writes, compact or structured output, saved result refs, and local result inspection.

Use when working with Jira Cloud through the jira CLI, including assigned issue lists, issue details with local inline image files, remote links, transitions, safe issue assignment, worklogs, descriptions, summaries, and comments.

Guide on how to remotely debug SAP BTP Cloud Foundry Node.js applications by combining deployed compiled JS discovery, Cloud Foundry log evidence, live HTTP request/response traces, runtime inspector snapshots, and read-only HANA evidence when debugging errors or exploring runtime behavior.

Use when analyzing SAP CAP CDS/HANA model structure with hana-lens, including building a compact CSN cache, fuzzy or regex entity search, field search, incoming reference lookup, dense entity descriptions, and safe association expansion.

Core agent-browser usage guide. Read this before running any agent-browser commands. Covers the snapshot-and-ref workflow, navigating pages, interacting with elements (click, fill, type, select), extracting text and data, taking screenshots, managing tabs, handling forms and auth, waiting for content, running multiple browser sessions in parallel, and troubleshooting common failures. Use when the user asks to interact with a website, fill a form, click something, extract data, take a screenshot, log into a site, test a web app, or automate any browser task.

Start or delegate work to a configured project subagent and ensure its configured skills are loaded. Use when AGENTS.md or the user says to call, launch, spawn, invoke, delegate to, or use a specialized subagent; when a task matches an available subagent listed in AGENTS.md; or when a platform-specific subagent command is needed for Antigravity or Codex.

Use when inspecting SAP BTP CF app audit events, SSH/debug activity, crashes, health, or live polling with cf-events.

Use when a task involves listening to or publishing messages to SAP Event Mesh on SAP BTP Cloud Foundry. Useful for interacting with event queues and topics directly from the CLI without needing an external client.

Use when a task involves debugging a Node.js app on SAP BTP Cloud Foundry through remote inspector access, including setting breakpoints or logpoints, capturing variables/scopes/stacks, watching exceptions, evaluating runtime state, listing loaded scripts, opening CF tunnels, or troubleshooting breakpoint path mapping with the cf-inspector CLI.

Use when capturing live HTTP request and response traces from SAP BTP Cloud Foundry Node.js apps, including Node inspector tunnel setup, bounded event streams, body/header capture controls, and runtime hook cleanup.

Use when discovering SAP CAP or OData API endpoints on SAP BTP Cloud Foundry, including root endpoint catalogs, OData metadata expansion, and XSUAA bearer token discovery.

Use when exploring deployed SAP BTP CF app files, searching code (grep), viewing file contents, locating app roots, or inspecting runtime candidate lines through the cf-explorer CLI.

Use when working with SharePoint-hosted .xlsx files through sharepoint-excel, including app-only auth, profiles, drive discovery, and workbook read/write operations.

Use when opening a Node.js inspector tunnel, debugging a SAP BTP CF app, or forwarding port 9229 from an app using the cf-debugger CLI.

Use when a task involves fetching, streaming, compacting, saving, or inspecting SAP BTP Cloud Foundry application logs with the cf-logs CLI, including compact output, compact refs, full-row drill-down, local session cleanup, and bounded local log stores.

Use when exporting project artifacts (package.json, lockfiles, .cdsrc.json, default-env.json, .npmrc) from a running SAP BTP CF app.

Use when a task involves syncing, reading, refreshing, or troubleshooting SAP BTP Cloud Foundry topology and HANA binding snapshots with the cf-sync CLI or @saptools/cf-sync package, including cached region/org/space/app discovery, targeted refreshes, DB binding selector resolution, local ~/.saptools state, and packages that depend on cf-sync snapshots.