Skip to content

docs: fix broken links to pi-ai (404), split into coding-agent and ai packages#277

Open
mario-gc wants to merge 6 commits intonexu-io:mainfrom
mario-gc:docs/fix-pi-pi-ai-links
Open

docs: fix broken links to pi-ai (404), split into coding-agent and ai packages#277
mario-gc wants to merge 6 commits intonexu-io:mainfrom
mario-gc:docs/fix-pi-pi-ai-links

Conversation

@mario-gc
Copy link
Copy Markdown

@mario-gc mario-gc commented May 2, 2026

Summary

Fixes broken links across files that pointed to https://github.com/mariozechner/pi-ai (404). The project monorepo is at badlogic/pi-mono, so links need to point to the correct package paths.

Problem

Every mention of pi and pi-ai in the READMEs and docs is a dead link. The monorepo is structured into:

  • packages/coding-agent: the pi CLI.
  • packages/ai: @mariozechner/pi-ai, the multi-provider LLM API library.

Fix

  • Text that says "pi" / "Pi" (the CLI) links to https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent.
  • Text that says "pi-ai" (the provider library) links to https://github.com/badlogic/pi-mono/tree/main/packages/ai (via the shared [piai] reference definitions).

Closes #275.

All links to https://github.com/mariozechner/pi-ai returned 404 after
the project was restructured into the badlogic/pi-mono monorepo.

- "pi" / "Pi" (the CLI tool the daemon scans for) now points to
  packages/coding-agent
- "pi-ai" (the multi-provider LLM API) now points to packages/ai
  via the shared [piai] reference definitions

Closes nexu-io#275.
@lefarcen
Copy link
Copy Markdown
Contributor

lefarcen commented May 2, 2026

Hi @mario-gc! 🎉
Thanks for the contribution — fixing these broken pi-ai links and clarifying the monorepo structure is super helpful.
I will run a deep review and get back to you within 24h.

Thanks for making open-design better!
— open-design team

@lefarcen lefarcen added the documentation Improvements or additions to documentation label May 2, 2026
Copy link
Copy Markdown
Contributor

@lefarcen lefarcen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @mario-gc! Thanks for catching this — fixing these broken pi-ai links is a solid cleanup.

What's good:

  • ✅ Link correctness verified: both new URLs (coding-agent and ai packages) resolve correctly to the pi-mono monorepo
  • ✅ Consistent updates across all 9 files (6 READMEs + 3 docs)
  • ✅ Correct semantic split: pi CLI → packages/coding-agent, pi-ai library → packages/ai
  • ✅ Closes #275 as stated

Minor observations (non-blocking):

  • docs/references.md:23 still references @mariozechner/pi-ai as a descriptive package name (not a link), which is technically correct (that's the npm package name). No action needed unless you want to add a note that the npm package lives in the monorepo now.
  • docs/roadmap.md:174 mentions @mariozechner/pi-ai in a "scope creep" discussion cell — also fine as-is (it's describing a hypothetical future scenario).

Ship as-is. 🚀

mario-gc added 5 commits May 3, 2026 07:17
…inks

Resolve README.md conflict: take upstream/main content (adds devin to agent list,
12-agent count) and fix the broken pi link from
github.com/mariozechner/pi-ai to
github.com/badlogic/pi-mono/tree/main/packages/coding-agent.
…inks

Resolve README.fr.md conflict: upstream rewrote agents paragraph to reference
apps/daemon/src/agents.ts + multi-provider API mode. Fixed Pi link in agents
table (upstream added Mistral Vibe row, multi-provider BYOK row).

Fix broken links in new README.uk.md (Ukrainian, added by upstream):
- [piai] reference: mariozechner/pi-ai -> badlogic/pi-mono/packages/ai
- Pi CLI link: mariozechner/pi-ai -> badlogic/pi-mono/packages/coding-agent
…inks

Resolve README.md conflicts: upstream added Kilo CLI and DeepSeek TUI
to agents paragraph and table. Fixed broken Pi links in both locations.

Fix broken links in new README.pt-BR.md (Brazilian Portuguese, added by
upstream): [piai] reference, Pi CLI link, Pi table link.
@mario-gc mario-gc requested a review from lefarcen May 5, 2026 05:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: fix broken links to pi-ai (404), split into coding-agent and ai packages

2 participants