Conversation
Verified all documentation against the codebase and fixed 9 issues: - Remove nonexistent demo/ package from CLAUDE.md - Move session_manager.go reference from app/ to manager/ - Add 9 undocumented packages to CLAUDE.md package structure - Add Linear to issues/ package description - Fix runner map name (claudeRunners → runners) - Fix MCP socket path format (pl-<shortID>.sock) - Fix theme switching claim in README (no 't' shortcut) - Replace removed workflow config feature card in index.html - Fix broken #usage footer link in index.html Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
This PR updates public-facing documentation to better match the current behavior and structure of the codebase (package layout, UI behavior, and documentation site links).
Changes:
- Update docs landing page feature card content and fix the footer “docs” anchor link.
- Correct README theme-switching instructions.
- Refresh CLAUDE.md package tree and various implementation details (runner map name, session manager location, MCP socket path format, issue providers).
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| docs/index.html | Renames a feature card and fixes the footer docs link anchor. |
| README.md | Corrects theme switching instructions to reflect current UX. |
| CLAUDE.md | Updates internal package inventory and several implementation details. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| configure allowed tools, squash-on-merge, and issue provider | ||
| mapping per repository via the settings modal. |
There was a problem hiding this comment.
The new feature card text says allowed tools and squash-on-merge can be configured “via the settings modal”, but the current Settings modal only exposes theme/branch prefix/notifications/auto-cleanup (see internal/ui/modals/config.go), and there doesn’t appear to be UI for repo-level allowed tools or squash-on-merge. Consider adjusting this copy to match the actual configuration surfaces (e.g., allowed tools via permission prompts / config file; issue mapping via session settings; remove squash-on-merge mention unless it’s user-configurable in the UI).
| configure allowed tools, squash-on-merge, and issue provider | |
| mapping per repository via the settings modal. | |
| configure allowed tools via permission prompts or config file, | |
| and issue provider mapping via session settings, per repository. |
|
|
||
| 1. Claude CLI started with `--permission-prompt-tool mcp__plural__permission` | ||
| 2. MCP server communicates with TUI via Unix socket (`/tmp/plural-<session-id>.sock`) | ||
| 2. MCP server communicates with TUI via Unix socket (`/tmp/pl-<shortID>.sock`, first 12 chars of session ID) |
There was a problem hiding this comment.
The socket path is documented as /tmp/pl-<shortID>.sock, but the implementation uses filepath.Join(os.TempDir(), "pl-"+shortID+".sock") (internal/mcp/socket.go). os.TempDir() is not always /tmp (e.g., macOS often uses /var/folders/...). Consider documenting it as $TMPDIR/pl-<shortID>.sock (or “in the OS temp dir”) to avoid inaccuracy.
| 2. MCP server communicates with TUI via Unix socket (`/tmp/pl-<shortID>.sock`, first 12 chars of session ID) | |
| 2. MCP server communicates with TUI via Unix socket in the OS temp directory (e.g., `$TMPDIR/pl-<shortID>.sock`, first 12 chars of session ID) |
Summary
demo/package, fixsession_manager.golocation (app/ → manager/), add 9 undocumented packages, add Linear to issues/ description, fix runner map name (claudeRunners→runners), fix MCP socket path formattshortcut exists — themes are changed via settings modal)#usagefooter anchor →#quick-startTest plan
internal/directory listingshortcuts.go🤖 Generated with Claude Code