Skip to content

Setup explorbot for API testing#119

Open
DavertMik wants to merge 4 commits into
masterfrom
feat/explorbot-api-setup
Open

Setup explorbot for API testing#119
DavertMik wants to merge 4 commits into
masterfrom
feat/explorbot-api-setup

Conversation

@DavertMik

Copy link
Copy Markdown
Contributor

No description provided.

@@ -0,0 +1,288 @@
---
name: explorbot-api-setup
description: Use to set up AI-powered API testing with Explorbot (the `api` subcommand). The skill ends when `explorbot api plan <endpoint>` produces a non-empty plan file AND `explorbot api test <plan> 1` exits `0`. Performs the work itself — edits the config, writes baseline knowledge, runs the curl ladder, runs the plan and a single test — only stopping to ask the user for the things only they know (base endpoint, auth headers / token, OpenAPI spec location, the endpoint to verify against).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AND explorbot api test <plan> 1 exits 0

what does 1 mean?


**Scope ends at one successful `explorbot api test <plan> 1`.** Running full `explore`, multi-style planning, or writing extra knowledge files is not part of setup — once one test passes, hand off to [[explorbot-fundamentals]] (`docs/api-testing.md` topic).

**Do the work — don't narrate it.** Edit the config, write knowledge via `npx explorbot api know`, run `curl`, run `npx explorbot api plan`, run `npx explorbot api test`. The user is only asked for the things only they know:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do the work — don't narrate it.

nice))


```bash
set -a && source .env && set +a
curl -sS -H "Authorization: Bearer $<KEY_NAME>" -w "\nHTTP %{http_code}\n" <baseEndpoint>/<one-endpoint-from-§2D>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what is §2D?


- [[explorbot-setup]] — install Explorbot from scratch and verify it can reach the user's web app. Use this first when `node_modules/explorbot/` is missing.
- [[explorbot-fundamentals]] — everything beyond setup (running, configuring, troubleshooting); see `node_modules/explorbot/docs/api-testing.md` for the API-mode reference.
- [[explorbot-debug]] — diagnose a failed API session from `output/explorbot.log` + recorded requests.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not such skill
is it planned?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants