Skip to content

feat: rework AI section and add Jupiter CLI page#857

Merged
0xYankee-Raccoons merged 9 commits intomainfrom
feat/ai-rework
Mar 23, 2026
Merged

feat: rework AI section and add Jupiter CLI page#857
0xYankee-Raccoons merged 9 commits intomainfrom
feat/ai-rework

Conversation

@0xYankee-Raccoons
Copy link
Copy Markdown
Collaborator

@0xYankee-Raccoons 0xYankee-Raccoons commented Mar 18, 2026

Summary

Reworks the AI section around two audiences ("Trade with AI" and "Build with AI") and adds a new Jupiter CLI documentation page.

Changes

  • ai/index.mdx: Restructured as a high-level get started page with two CardGroup sections routing users by intent
  • ai/cli.mdx (new): Jupiter CLI page covering install, key setup, and three usage paths (terminal, Telegram via OpenClaw, AI agents), plus product command references for Spot, Perps, and Lend
  • docs.json: Updated AI nav from flat "AI Resources" to two groups: "Trade with AI" (CLI) and "Build with AI" (MCP, Skills, llms.txt)
  • ai/mcp.mdx: Removed trading MCP reference
  • llms.txt: Regenerated

Trading MCP placeholder page removed - will be tracked as a separate issue when the hosted MCP server is ready.

Linear Issues

  • Fixes DEVREL-102 — [Docs] Rework AI section and add Jupiter CLI

Checklist

  • node generate-llms-from-docs.js run
  • mint broken-links passes
  • All pages have title, description, llmsDescription
  • docs.json navigation updated
  • No trading MCP references remain
  • Redirects added (if paths changed)
  • Changelog entry added to updates/index.mdx (if API/product change)
  • .claude/rules/ updated with any learnings or decisions

Generated with Claude Code

- Restructure AI overview as high-level get started page with two paths
- Add Jupiter CLI page with terminal, Telegram (OpenClaw), and AI agent setup flows
- Add placeholder Trading MCP page
- Update docs.json nav: Trade with AI (CLI, MCP) / Build with AI (MCP, Skills, llms.txt, Ecosystem)

Fixes DEVREL-102
- Remove ecosystem page (not needed)
- Fix overview description wording
- Add miniclaw as lightweight alternative in CLI Telegram section
- Fix MCP page: clarify it searches docs, not scaffold API calls;
  rename to "Documentation MCP" to disambiguate from Trading MCP
- Rewrite skills page to focus on Jupiter Skills Repository with
  both skills (integrating-jupiter, jupiter-lend)
- Move llms.txt "how it's generated" to a note at top of page
- Fix em dashes, British English spelling, and cross-links
- Improve trading-mcp.mdx placeholder (remove content from callout)
- Regenerate llms.txt

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Restructure to Install -> Usage -> Ways to Use. Minimal install
(npm only, link to repo for alternatives). Usage section directs
readers/LLMs to the CLI repo docs as single source of truth
instead of replicating command references here.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Trading MCP is not ready yet - remove the placeholder page and all
references. Will be added back as a separate issue when the hosted
MCP server is available.

- Delete ai/trading-mcp.mdx
- Remove from docs.json navigation
- Remove card from ai/index.mdx
- Remove reference from ai/mcp.mdx
- Regenerate llms.txt

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add redirect for deleted ai/ecosystem page
- Fix grammar: "integrates" → "integrate" in ai/index.mdx
- Update stale AI section description in llms.txt generator
- Add Node.js note for npx skills install command
- Trim OpenClaw capabilities tip in ai/cli.mdx
- Log ecosystem redirect in decisions.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@0xYankee-Raccoons 0xYankee-Raccoons merged commit 9bbacf6 into main Mar 23, 2026
4 checks passed
@0xYankee-Raccoons 0xYankee-Raccoons deleted the feat/ai-rework branch March 23, 2026 12:28
0xYankee-Raccoons added a commit that referenced this pull request Mar 23, 2026
Replace the file-scan → nested-tree → sort-by-nav approach with a
direct nav-tree walker (anchors → products → versions → groups → pages).
Eliminates buildNestedStructure, sortNestedData, findValueForApiReference
and all YAML processing.

Fixes:
- Ghost headings from deprecated Swap V1 and Recurring API ref pages
- "Ai" heading (now correctly "AI" from nav)
- Products now group docs + guides + API ref together
- Empty sections auto-removed

Also merges main: adds ai/cli page, Price API blog post, removes
ai/ecosystem (deleted in #857), and updates nav accordingly.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
0xYankee-Raccoons added a commit that referenced this pull request Mar 23, 2026
Split AI into two groups per the AI rework:
- Trade with AI (CLI)
- Build with AI (MCP, Skills, llms.txt)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
0xYankee-Raccoons added a commit that referenced this pull request Mar 27, 2026
…rview (#859)

* revert: remove custom sidebar nesting limit (top-3)

Delete dropdown.js and remove all dropdown-related CSS from style.css.
The sidebar now shows all items by default on both desktop and mobile.

This reverts the changes from PRs #811, #812, and #813.

Closes DEVREL-116

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: restructure nav to product-centric layout (Phase 1)

Rename "Docs" tab to "Products". Each product section now includes
its docs + API reference in one sidebar. Removes standalone "Guides",
"API Reference", and "Tool Kits" tabs (8 tabs to 6).

- Swap: docs + API ref (V2 only)
- Tokens & Price: combined as one product
- Lend, Prediction, Trigger, Recurring, Portfolio, Send, Studio:
  docs + API ref colocated
- Tool Kits: own product section (Plugin, Wallet Kit, Referral)
- V1/legacy pages hidden from nav entirely (files preserved)
- Guides removed from nav (files preserved)

No file moves, no URL changes, no redirects. Navigation only.

Phase 1 of DEVREL-115. Known trade-off: llms.txt still generates
from file paths, not nav structure. Phase 2 will address this by
consolidating file paths to match the nav.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: restore dropdown max-height styles

Keep the extended dropdown height for the Products menu (80vh mobile,
600px desktop) without the top-3 collapse logic that was removed.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: 2-column Products dropdown layout

Add CSS grid to display Products menu in two columns on desktop:
- Left: Swap, Tokens & Price, Lend, Perps, Trigger, Recurring, Prediction
- Right: Portfolio, Send, Studio, Lock, Routing, Tool Kits

Uses grid-template-rows: repeat(7, auto) with grid-auto-flow: column
to split 13 items into 7+6 across two columns. Mobile stays single column.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: widen Products dropdown to prevent text wrapping

Add min-width: 420px to the 2-column dropdown so items like
"Tokens & Price" and "Tool Kits" don't wrap to a second line.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: standardise product nav structure and add missing guides

- Pattern A: remove unnamed " " groups, put overview in first named group
- Remove API ref overview pages from nav (redundant navigation hubs)
- Add swap widget guide to Swap, token/price guides to Tokens & Price,
  prediction guide to Prediction

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: tokens & price nav improvements

- Unnest V2 subgroup in Tokens, show pages at top level
- Combine About Price and Price V3 into single doc
- Remove docs/price/v3 from nav (content merged into index)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: move Swap V2 docs to root path, remove /v2/ from URLs

Latest Swap docs no longer need /v2/ in the URL path - only legacy
versions (V1) retain their version prefix. Updates all internal links
across swap, ultra, and API reference docs.

- Move 14 files: docs/swap/v2/* -> docs/swap/*, api-reference/swap/v2/* -> api-reference/swap/*
- Update /docs/swap/v2/ -> /docs/swap/ links in 40 files
- Update /api-reference/swap/v2/ -> /api-reference/swap/ links

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: restructure nav to anchors-based product layout

Replace tabs/menu navigation with anchors as root element.
Each product is a separate entry in the product switcher within
a "Products" anchor. Non-product sections (Get Started, AI,
Changelog, Resources) are persistent top-level anchors.

- Root navigation: anchors (Helius-style persistent sidebar nav)
- Products anchor: contains all 13 products with product switcher
- Swap: V2 (Latest) + V1 (Legacy with Ultra and Metis)
- Trigger: Trigger V2 (Latest) + Trigger V1 (Legacy)
- Global anchors: Dashboard (external), AI, Changelog, Resources
- Theme: willow
- Add redirects for old /docs/swap/v2/ URLs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: UI and content updates

- Update style.css with custom CSS (product/version selector experiments, commented out)
- Rename updates/index.mdx to changelog/index.mdx
- Update index.mdx landing page

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: move Trigger V2 API refs to root path, remove /v2/ from URLs

Standardise with Swap: latest API version has no version prefix in URL,
only legacy (V1) retains /v1/ prefix.

- Move 11 files: api-reference/trigger/v2/* -> api-reference/trigger/*
- Rename v2.mdx overview to index.mdx
- Update internal links in trigger overview pages
- Add redirects for old /api-reference/trigger/v2/ URLs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: address PR review feedback

- Fix missing comma in Price page fetch code example
- Fix "elimate" typo in Price page limitations
- Rewrite casual V3 comparison to match docs style guide
- Fix llms generator to handle anchors-based nav structure
- Update llms generator for updates/ → changelog/ rename

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: deduplicate llms.txt API reference entries

- Add api-reference/ to generator folders, remove openapi-spec/
  (use per-endpoint MDX frontmatter instead of generic YAML titles)
- Add URL-based deduplication to prevent duplicate entries from
  pages referenced in multiple nav locations
- Add depth guard to prevent stack overflow in processSection
- Add missing description frontmatter to 11 trigger V2 API ref files
- Fix generator for updates/ → changelog/ folder rename
- Update AI section description to remove stale ecosystem reference

Before: 302 entries with 89 duplicates (24x prediction, 12x trigger, etc.)
After: 224 unique entries, 0 duplicates

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: address PR review should-fix items for nav structure

- Flatten Swap V1 Legacy nesting: drop About/Guide/API Reference
  sub-groups from Ultra and Metis, reducing from 5 to 3 levels
- Consistent group naming: drop "API" suffix from first groups
  (Swap API → Swap, Trigger API → Trigger, etc.)
- Separate Tokens & Price into standalone products
- Combine thin products (Portfolio, Send, Studio, Lock) into "More"
- Add Guides index to Get Started anchor for cross-cutting discovery
- Regenerate llms.txt (237 entries, 0 duplicates)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: split Swap V1 into separate Ultra V1 and Metis V1 versions

Ultra and Metis were separate APIs - they each get their own version
entry in the picker instead of being grouped under one Swap V1.
Also splits docs/API ref into separate groups within each version.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: revert to single Swap V1 version with Ultra and Metis groups

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: split Swap versions into Swap V2, Ultra V1, and Swap V1

Three version entries in the picker:
- Swap V2 (Latest) - unified swap API
- Ultra V1 (Legacy) - Ultra docs + API ref
- Swap V1 (Legacy) - Metis docs + API ref

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: align AI nav with PR #857 structure

Split AI into two groups per the AI rework:
- Trade with AI (CLI)
- Build with AI (MCP, Skills, llms.txt)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: address PR review must-fix and should-fix items

Must fix:
- Update Quick Reference Trigger endpoint from V1 to V2

Should fix:
- Deprecate orphaned guides (Ultra swap, Metis custom swap) with
  Warning callouts pointing to Swap V2 equivalents
- Update guides index to link to V2 docs instead of deprecated guides
- Clarify Perps summary: on-chain program, no REST API
- Created DEVREL-122 for API ref llmsDescription content debt (~65 pages)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: streamline Get Started nav - drop overview, merge guides

Remove get-started/overview (redundant with landing page + product
switcher). Merge guides/index into main group so Get Started has:
landing page, get started tutorial, guides index, env setup, dev basics.

Created DEVREL-123 to update Get Started tutorial from Ultra V1 to
Swap API V2.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: CLAUDE.md compliance - deprecation workflow and decisions log

- Add DEPRECATED prefix to llmsDescription on deprecated guides
  (Ultra swap, Metis custom swap) per deprecation workflow step 5
- Deprecate get-started/overview.mdx (removed from nav, redundant)
- Deprecate docs/price/v3.mdx (orphaned, replaced by docs/price/index)
- Update guides/index.mdx sidebar title to "Guides"
- Add nav restructure decision entry to .claude/rules/decisions.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: remove issuer, fees, stats7d, stats30d from Tokens V2 API

Remove deprecated response fields from:
- OpenAPI spec (schema definition + example)
- Token information guide (TypeScript interface + JSON example)
- Get started tutorial (JSON example)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Revert "fix: remove issuer, fees, stats7d, stats30d from Tokens V2 API"

This reverts commit 9d3ea8c.

* fix: clean up Get Started anchor pages

- Remove root landing page (index.mdx)
- Fix broken accordion in get-started tutorial (duplicate closing tags)
- Replace nested Cards with proper CardGroup in Next Steps
- Rewrite environment-setup.mdx: fix syntax error, tighten content
- Rewrite development-basics.mdx: reduce verbosity, consolidate tips
- Reorder nav: landing → tutorial → setup → basics → guides

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: add PR review screenshots (temporary)

* fix: wrong theme

* chore: update PR review screenshots (maple vs mint)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: update PR screenshots - tabs nav, maple vs mint

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: update PR screenshots - tabs vs anchors, maple vs mint

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: switch navigation from anchors to tabs

Tabs provide horizontal text labels at the top of the sidebar
instead of icon buttons. Theme set to maple.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: switch navigation from anchors to tabs with maple theme

- Get Started, AI, Changelog, Resources become top-level tabs
- Products use product selector with version dropdowns
- Merge Ultra V1 + Metis into single Swap V1 version
- Fix Price icon from tag to dollar-sign
- Strip style.css to essential overrides

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: mark Swap V1, Ultra V1, and Trigger V1 as unmaintained

- Add Warning callouts to 48 pages pointing to replacements
- Prefix llmsDescription with UNMAINTAINED on all affected pages
- Document unmaintained pages workflow in CLAUDE.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: update llms.txt generator for tabs and unmaintained exclusion

- Rewrite nav walker from anchors to tabs/products/versions
- Skip versions tagged Unmaintained from llms.txt output
- Rename anchor summaries to tab summaries

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: remove navigation comparison screenshots

No longer needed after deciding on tabs + maple theme.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: merge Get Started into Docs tab, separate Tool Kits tab

- Rename Products tab to Docs, add Get Started as first product
- Move Tool Kits from product selector to its own tab
- Tab order: Docs, AI, Tool Kits, Changelog, Resources
- Update llms.txt generator summaries to match new structure

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: merge Routing product into Swap, deprecate market/token listing

- Move routing pages to docs/swap/routing/ (dex-integration, rfq-integration)
- Enrich swap routing overview with Juno architecture and endpoint availability
- Add Routing group to Swap V2 with integration pages
- Remove Routing as standalone product from nav
- Deprecate market-listing and token-listing (no longer applicable in V2)
- Deprecate docs/routing/index (replaced by docs/swap/routing)
- Add redirects for all moved and deprecated routing pages

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: drop Juno/Iris references, delete old routing pages

- Replace all Juno and Iris mentions with Metis in routing overview
- Delete docs/routing/ pages entirely (redirects in docs.json cover old URLs)
- Update CLAUDE.md deprecation workflow to allow deletion with redirects

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: routing page copy improvements

- Title Case headings, remove duplicate Routers table
- Improve /build Warning with technical reason (JupiterZ MM backend restriction)
- Add JupiterZ info note to rfq-integration page

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: add API reference and navigation cards to Swap overview

- Add API Reference card group (GET /order, GET /build, POST /execute)
- Add Learn More card group (Routing, Fees, Advanced, Migration)
- Replace plain Related links with structured cards

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: combine AI tab into single group

- Merge "Trade with AI" and "Build with AI" into one flat group
- Reorder: llms.txt, Skills, MCP, CLI (discovery tools first)

Fixes DEVREL-126

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: update routing card description to mention liquidity integration

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: rewrite AI overview with environment-based tool guide

- Replace Trade/Build split with Read Docs vs Execute Operations
- Add environment matrix (local vs hosted agents)
- Add Jupiter MCP coming soon card
- Update frontmatter descriptions

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: use OpenAPI spec URLs for API reference pages in llms.txt

API reference pages are auto-generated from OpenAPI specs, so .md URLs
don't return raw content. Now links to their spec YAML instead
(e.g. /openapi-spec/swap/v2/swap.yaml). Regular docs pages keep .md.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: skip API reference overview pages from llms.txt

Overview pages are pure navigation cards with no API details.
Only endpoint pages with openapi specs are useful for LLMs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: delete API reference overview pages

Overview pages are pure card navigation with no API details.
The sidebar already shows endpoints directly. Mintlify auto-resolves
index paths to the first child page.

20 files deleted, 3 nav references removed from docs.json.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: unnest Tokens V2 and Price V3 paths, rewrite tokens overview

- Move docs/tokens/v2/* to docs/tokens/ (2 files)
- Move api-reference/tokens/v2/* to api-reference/tokens/ (7 files)
- Move api-reference/price/v3/price to api-reference/price/index (1 file)
- Rewrite docs/tokens/index.mdx as developer-focused overview
- Consolidate organic-score and token-tag-standard into tokens index
- Delete docs/price/v3.mdx (duplicate of index)
- Add redirects for all old v2/v3 paths
- Update internal links across guides, skills, and docs pages

Fixes DEVREL-130

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: refresh get-started landing page copy, nav grouping, and llms description

- rename get-started sidebar title to "Welcome to Jupiter"
- group pages under "Get Started" in sidebar navigation
- replace repetitive "AI Tools" card with "API Reference"
- remove "Building on Solana" and add a socials section (Blog, Twitter/X)
- update index llmsDescription to match current page structure

* fix: broken link

* theme: mint with dropdown menu, no product and version nav

* cleanup: update Ultra V1 and Swap V1 references across maintained pages

- Replace "Ultra Swap API" with "Swap API" in get-started, resources,
  tool-kits, and AI pages; update links from /docs/ultra to /docs/swap
- Add Developer Platform callout to all 7 portal pages
- Update labelling tables in brand-kit and legal
- Clean up llmsDescription fields and regenerate llms.txt

Refs: DEVREL-129

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: llms.txt generator missing Docs tab, update stale decisions.md

- Fix critical bug: walkTopLevel didn't handle menu-based nav, causing
  entire Docs tab (all API products) to be excluded from llms.txt
  (47 → 218 entries)
- Merge PRODUCT_SUMMARIES and TAB_SUMMARIES into single SECTION_SUMMARIES
- Add console.warn for skipped API ref pages without openapi field
- Update decisions.md nav entry: anchors → tabs, 3 swap versions → 2,
  willow → mint theme, add routing merge and menu structure details

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix links in docs.json

* fix: redirects

* fix: footer

* fix: Ultra API ref llmsDescription and unmaintained workflow

- Replace generic llmsDescription on 7 Ultra API ref pages with
  specific endpoint descriptions prefixed with UNMAINTAINED
- Update CLAUDE.md unmaintained workflow: pages are removed from nav
  (not kept under version selectors), accessible via direct URL only

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: broken tokens API ref link and organic score anchors

- /api-reference/tokens → /api-reference/tokens/search (no index page)
- /docs/tokens → /docs/tokens#organic-score for direct navigation (2 places)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: support urls

* feat: banner

* fix: seo

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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.

1 participant