docs: simplify MCP section with clear stance and minimal example

- State upfront: pi does not support MCP
- Provide minimal working example (README + bash script)
- Show simple usage pattern
- Remove verbose explanations

fix(tui): don't show duplicate URL when link text equals href

packages/coding-agent/README.md

@@ -320,36 +320,45 @@ Execute a bash command in the current working directory. Returns stdout and stde
 
 ### MCP & Adding Your Own Tools
 
-You don't need MCP to extend pi's capabilities. Agents are excellent at writing code and running bash commands - leverage that instead.
+**pi does not support MCP.** Instead, it relies on the four built-in tools above and assumes the agent can invoke pre-existing CLI tools or write them on the fly as needed.
 
-**The simple approach:**
+**Here's the gist:**
-- Write small CLI scripts for your specific needs (Node.js, Python, whatever)
-- Put them in your PATH or a dedicated `~/agent-tools` directory
-- Document them in a README that you point your agent to when needed
 
-**Why this works:**
+1. Create a simple CLI tool (any language, any executable)
-- **Token efficient**: A 225-token README beats a 13,000-token MCP server description
+2. Write a concise README.md describing what it does and how to use it
-- **Composable**: Chain tools with bash pipes, save outputs to files, process results with code
+3. Tell the agent to read that README
-- **Easy to extend**: Need a new tool? Ask your agent to write it for you
-- **No overhead**: No server processes, no protocol complexity, just executables
 
-**Example structure:**
+**Minimal example:**
+
+`~/agent-tools/screenshot/README.md`:
+```markdown
+# Screenshot Tool
+
+Takes a screenshot of your main display.
+
+## Usage
 ```bash
-# Set up tools directory
+screenshot.sh
-mkdir -p ~/agent-tools/browser-tools
-cd ~/agent-tools/browser-tools
-
-# Create minimal CLI tools (e.g., start.js, nav.js, screenshot.js)
-# Document them in README.md
-# Add to PATH or reference in AGENT.md
-
-# In your session:
-# "Read ~/agent-tools/browser-tools/README.md and use those tools"
 ```
 
-The agent already knows how to use bash, write code, and compose results. Building on these primitives is often simpler, more flexible, and more efficient than integrating an MCP server.
+Returns the path to the saved PNG file.
+```
 
-For a detailed walkthrough and real examples, see: [What if you don't need MCP at all?](https://mariozechner.at/posts/2025-11-02-what-if-you-dont-need-mcp/)
+`~/agent-tools/screenshot/screenshot.sh`:
+```bash
+#!/bin/bash
+screencapture -x /tmp/screenshot-$(date +%s).png
+ls -t /tmp/screenshot-*.png | head -1
+```
+
+**In your session:**
+```
+You: Read ~/agent-tools/screenshot/README.md and use that tool to take a screenshot
+```
+
+The agent will read the README, understand the tool, and invoke it via bash as needed. If you need a new tool, ask the agent to write it for you.
+
+For a detailed walkthrough with real examples, see: https://mariozechner.at/posts/2025-11-02-what-if-you-dont-need-mcp/
 
 ## Security (YOLO by default)
 

packages/tui/src/components/markdown.ts

@@ -307,7 +307,12 @@ export class Markdown implements Component {
 
 				case "link": {
 					const linkText = this.renderInlineTokens(token.tokens || []);
-					result += chalk.underline.blue(linkText) + chalk.gray(` (${token.href})`);
+					// If link text matches href, only show the link once
+					if (linkText === token.href) {
+						result += chalk.underline.blue(linkText);
+					} else {
+						result += chalk.underline.blue(linkText) + chalk.gray(` (${token.href})`);
+					}
 					break;
 				}