ottoport 1.3.1 → 1.3.2

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ottoport",
   "description": "One API for every model. Call chat, image, video, speech and music models through the OttoPort gateway — as MCP tools, slash commands, or the bundled CLI.",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "author": {
     "name": "LITBOX LLC",
     "email": "support@ottoport.ai"

package/README.md

@@ -1,28 +1,52 @@
-# OttoPort for Claude Code
+# OttoPort
 
-One API for every model. This plugin bundles three things into a single
-install: the OttoPort **MCP server**, the **`ottoport` skill**, and a set of
-**slash commands** for chat, image, video, speech, and music generation.
+One API for every model. This package is three things over the same gateway:
+a **CLI**, an **MCP server**, and a **Claude Code plugin** — chat, image,
+video, speech, and music, on one key and one prepaid balance.
 
-## Install
+Get a key at <https://ottoport.ai/api-keys> (they look like `op-…`), then pick
+whichever surface fits.
 
-```
-/plugin marketplace add https://ottoport.ai/plugin/marketplace.json
-/plugin install ottoport@ottoport
-```
+## CLI
 
-Then set your key in the shell that launches Claude Code — the MCP server reads
-the environment it inherits, so a key exported inside a session is too late:
+```bash
+npm install -g ottoport     # or run any command below through `npx ottoport …`
+export OTTOPORT_API_KEY=op-...
+```
 
 ```bash
-export OTTOPORT_API_KEY=op-...          # create one at https://ottoport.ai/api-keys
-export OTTOPORT_BASE_URL=https://ottoport.ai   # optional; this is the default
+ottoport models [--modality chat|image|video|tts|music] [--json]
+
+ottoport chat  "<prompt>" [--model claude-sonnet-5] [--system "..."] [--no-stream]
+                          [--temperature 0.7] [--max-tokens 512]
+ottoport image "<prompt>" [--model gpt-image-2] [--size 1024x1024] [--n 1]
+                          [--image <url>] [--out file.png]
+ottoport video "<prompt>" [--model kling-3.0] [--duration 5]
+                          [--aspect-ratio 16:9] [--image <url>] [--out clip.mp4]
+ottoport speech "<text>"  [--model gpt-4o-mini-tts] [--voice alloy] [--out speech.mp3]
+ottoport music "<prompt>" [--model suno-v5] [--duration 15] [--out song.mp3]
+
+ottoport install <host>   # wire the MCP server into an agent
+ottoport mcp              # run the MCP server on stdio
 ```
 
-Run `/ottoport:setup` to confirm the key, the gateway, and the MCP tools are all
-live.
+Chat streams by default. Image, video and audio commands print the result URL;
+`--out` downloads it. `--url` and `--key` override the environment for a single
+call.
+
+Every command is a thin client over the public REST API, so anything the CLI
+does is available to your own code — the gateway is OpenAI-compatible, and any
+OpenAI SDK works by pointing `baseURL` at `https://ottoport.ai/api/v1`.
+
+## Claude Code plugin
 
-## Slash commands
+Brings the MCP server, the `ottoport` skill, and six slash commands in one
+install:
+
+```
+/plugin marketplace add https://ottoport.ai/plugin/marketplace.json
+/plugin install ottoport@ottoport
+```
 
 | Command | What it does |
 | --- | --- |
@@ -33,23 +57,33 @@ live.
 | `/ottoport:speech` | Read text aloud, or generate music. |
 | `/ottoport:setup` | Diagnose key / gateway / MCP wiring. |
 
-## MCP tools
-
-The bundled server exposes `ottoport_list_models`, `ottoport_chat`,
-`ottoport_generate_image`, `ottoport_generate_video`, `ottoport_generate_speech`,
-and `ottoport_generate_music`. Any agent in the session can call them directly —
-the slash commands are just convenient entry points over the same tools.
-
-## CLI
+## Other agents
 
-The same package ships the `ottoport` CLI for terminal and CI use:
+Claude Code is the only host with a plugin format. Everywhere else, one command
+registers the MCP server by writing that agent's own config:
 
 ```bash
-npm install -g ottoport
-ottoport models --modality video
-ottoport image "isometric city at dusk" --out city.png
+npx ottoport install codex     # or hermes, cursor, windsurf, claude-desktop, claude
 ```
 
+Codex also gets the OttoPort skill copied into `~/.codex/skills/`. Your key is
+forwarded from the environment rather than written into any config file.
+
+## MCP tools
+
+`ottoport_list_models`, `ottoport_chat`, `ottoport_generate_image`,
+`ottoport_generate_video`, `ottoport_generate_speech`, `ottoport_generate_music`.
+The server speaks stdio JSON-RPC and is launched by the host as a subprocess, so
+it needs Node 20+ on the PATH of whatever starts that host.
+
+## Configuration
+
+- `OTTOPORT_API_KEY` — your `op-…` key. Export it from your shell profile: the
+  MCP server reads the environment its host was launched in, so a key exported
+  inside a running session arrives too late.
+- `OTTOPORT_BASE_URL` — defaults to `https://ottoport.ai`; set it only to point
+  at another deployment.
+
 ## Notes
 
 - Image, video, and audio calls return **URLs**, and provider URLs expire.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ottoport",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "Claude Code plugin, CLI and MCP server for OttoPort — one OpenAI-compatible API for every LLM, image, video, and speech model.",
   "homepage": "https://ottoport.ai",
   "license": "MIT",