Skip to main content
Adds a human-readable plain text page to your AixyzServer showing agent name, description, version, and skills.
server.unstable_withIndexPage();
This API is unstable and may change in future releases.

Signature

server.unstable_withIndexPage(path?: string): AixyzServer
ParameterTypeDefaultDescription
pathstring"/"Route path (must start with /)
Returns this for chaining.

Behavior

Registers a GET handler at the given path that responds with text/plain content:
My Agent
========

Description: A helpful travel agent
Version: 0.1.0

Skills:

1. Search Flights
   ID: search-flights
   Description: Search for flights between airports
   Tags: travel, flights
   Examples:
   - Find flights from SFO to LAX
The output includes:
  • Agent name and a separator line
  • Description and version from config
  • Skills list with IDs, descriptions, tags, and examples (if configured)

Usage

The auto-generated server calls unstable_withIndexPage() automatically at "/". In a custom server, call it explicitly:
import { AixyzServer } from "aixyz/server";

const server = new AixyzServer();
await server.initialize();

// Mount at root (default)
server.unstable_withIndexPage();

// Or mount at a custom path
server.unstable_withIndexPage("/info");

export default server;