Rippletide Import Agent CLI

rippletide-import-agent patches a supported TS/JS agent repository, extracts its system prompt and tool manifest, uploads the import artifacts to Rippletide, and prepares runtime live logging.

Public Install

Once the package is published to npm, anyone can run it without cloning this repo:

RIPPLETIDE_API_KEY=... npx -y @samirosamsam/rippletide-import-agent@latest --api-url https://agent-evalserver-staging.up.railway.app --app-url https://trust-client-staging.up.railway.app --agent-name "My Agent"

Or install it globally:

npm install -g @samirosamsam/rippletide-import-agent
RIPPLETIDE_API_KEY=... rippletide-import-agent --api-url https://agent-evalserver-staging.up.railway.app --app-url https://trust-client-staging.up.railway.app --agent-name "My Agent"

What The CLI Does

• scans a supported TS/JS agent repo for system prompt and tool definitions
• creates the imported agent on Rippletide
• uploads extracted import metadata
• patches supported agent callsites so traffic is proxied through Rippletide

Releasing To npm

The public package name is @samirosamsam/rippletide-import-agent.

For a public release:

1. Configure npm trusted publishing for this repository and the publish-import-agent.yml workflow, or provide an NPM_TOKEN GitHub secret with publish access.
2. Bump packages/import-agent/package.json to the next version.
3. Trigger the GitHub Actions workflow manually, or push a tag like import-agent-v1.0.0.

The package is configured for public publishing:

"publishConfig": {
  "access": "public"
}

Manual fallback from the package directory:

cd packages/import-agent
npm publish --access public

If npm account 2FA is enforced for publishes, the token must support non-interactive publishing.