Skillget

pontx

mcp
Security Audit
Fail
Health Warn
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 38 GitHub stars
Code Fail
  • process.env — Environment variable access in .agents/skills/pontx-metadata-quality-loop/scripts/score-metadata.mjs
  • spawnSync — Synchronous process spawning in .agents/skills/pontx-metadata-quality-loop/tests/score-metadata.test.mjs
  • process.env — Environment variable access in examples/pontx.config.example.ts
  • network request — Outbound network request in examples/pontx.config.example.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

OpenAPI lifecycle management for API discovery, documentation, type-safe SDK generation, CLI, MCP, and Agent workflows

README.md

Pontx

中文文档

Website and curated API catalog: pontx.dev

API lifecycle management tool built on the Pontx-Spec protocol (compatible with OAS2/OAS3, supporting ROA/RPC). Provides API search, documentation generation, code generation, and SDK management.

Features

  • Protocol Compatible — Extended Pontx-Spec protocol based on OAS2/OAS3, supporting both ROA and RPC styles
  • Code Generation — Generate type-safe client code from API definitions, multi-language support
  • VSCode Extension — API explorer, smart search, documentation viewer, one-click code generation
  • MCP Server — API search and code generation capabilities for AI tools
  • Multi-platform SDK — Browser and Node.js SDKs, ready to use out of the box
  • CLI Tool — Manage API metadata, validation, diff analysis, and code generation from the command line

Packages

Core

Package Version Description
pontx 1.0.0-beta.1 CLI tool & core engine
@pontx/spec 1.0.0-beta.1 Pontx-Spec protocol definitions
@pontx/mcp 1.0.0-beta.0 MCP Server implementation
vscode-pontx 2.0.8 VSCode extension
oas-spec-ts 0.6.4 OAS2/OAS3 TypeScript types

SDK

Package Version Description
@pontx/sdk 1.0.0-beta.1 Shared core utilities (Browser & Node.js)
@pontx/sdk-browser-client 0.0.11 Browser SDK
@pontx/nodejs-sdk 0.1.0 Node.js SDK (>= 18)

Plugins

Package Description
plugin-egg Egg.js framework plugin

Getting Started

Installation

npm install pontx -g

Install AI Skill (Recommended)

Pontx provides an AI Skill that helps AI assistants (Claude Code, Gemini CLI, etc.) understand your APIs and generate accurate code.

pontx skill
npx skills add https://github.com/pontjs/pontx --skill pontx

This installs a structured workflow guide into your project, enabling AI assistants to search APIs, generate type-safe code, and call APIs with full context — no manual prompting needed.

Tip: Run pontx skill in every project that uses APIs — it's the fastest way to get AI-powered API development.

Configuration

Create a pontx.config.ts in your project root:

import { PontxConfig } from "pontx";

export default {
  origins: [
    {
      name: "petstore",
      url: "https://petstore.swagger.io/v2/swagger.json",
    },
  ],
} as PontxConfig;

Generate Code

pontx generate

Using the SDK

import { createClient } from "@pontx/nodejs-sdk";

const client = createClient({
  baseURL: "https://api.example.com",
});

Development

Prerequisites

  • Node.js >= 18.0.0
  • pnpm >= 8.0.0

Install Dependencies

pnpm install

Build All Packages

pnpm build:all

Run Tests

pnpm test

Release

# Create a changeset
pnpm changeset

# Update versions
pnpm changeset:version

# Publish to npm
pnpm changeset:publish

Tech Stack

  • Language: TypeScript 5+
  • Build: Rollup / esbuild / tsup / webpack
  • Testing: Vitest
  • Frontend: React + Vite + TailwindCSS
  • Package Management: pnpm workspace + Changesets

License

MIT

Reviews (0)

No results found