diff --git a/.github/workflows/lint.yaml b/.github/workflows/lint.yaml index 8dea973..15e6084 100644 --- a/.github/workflows/lint.yaml +++ b/.github/workflows/lint.yaml @@ -42,4 +42,4 @@ jobs: - name: "install awesome-bot" run: gem install awesome_bot - name: "linting: ${{ matrix.files }}" - run: awesome_bot --allow-redirect --white-list https://github.com/jdorfman/awesome-amp-cli,https://example.com,https://github.com/user-attachments/assets/44099391-3976-473d-bcf8-95fd7b980f99,https://www.npmjs.com/package/llm-rules,https://www.npmjs.com/package/@sourcegraph/amp ${{ matrix.files }} + run: awesome_bot --allow-redirect --white-list https://github.com/lfglabs-dev/awesome-amp-code,https://example.com,https://github.com/user-attachments/assets/44099391-3976-473d-bcf8-95fd7b980f99,https://www.npmjs.com/package/llm-rules,https://www.npmjs.com/package/@sourcegraph/amp ${{ matrix.files }} diff --git a/AGENTS.md b/AGENTS.md index 0136124..b8999f8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -3,7 +3,7 @@ ## Build, Lint & Test Commands - Lint readme: `npx awesome-lint readme.md` -- Link check: `awesome_bot --allow-redirect --white-list https://github.com/jdorfman/awesome-amp-code,https://example.com readme.md` +- Link check: `awesome_bot --allow-redirect --white-list https://github.com/lfglabs-dev/awesome-amp-code,https://example.com readme.md` - Node.js version: Use v21.6.0 (as specified in .tool-versions) ## Code Style Guidelines @@ -21,9 +21,9 @@ - Main content is in amp_cli_docs.md and readme.md - CI pipeline uses awesome-lint and awesome_bot to validate content -## Add link to Built With section +## Add link to Projects & Tools section -When `/builtwith` followed by a link is included in a prompt, you will add the link to the Built With section of the README.md file. If there is a numbered list of urls, create subagents to complete the tasks. +When `/builtwith` followed by a link is included in a prompt, you will add the link to the "Projects & Tools" section of the README.md file under the appropriate subcategory (Documentation & Guides, Development Tools, Applications Built with Amp, or Browser & Misc). If there is a numbered list of urls, create subagents to complete the tasks. ## Add link to @docs/amp_faq.md diff --git a/contributing.md b/contributing.md index 4d1a103..69548a7 100644 --- a/contributing.md +++ b/contributing.md @@ -8,7 +8,7 @@ ALWAYS create a new branch with your proposed changes. Thank you! ## Adding an new Item -- Try to fit your item into an existing sections. [Open a suggestion](https://github.com/jdorfman/awesome-amp-code/issues/new) to start as discussion about any new sections. +- Try to fit your item into an existing sections. [Open a suggestion](https://github.com/lfglabs-dev/awesome-amp-code/issues/new) to start as discussion about any new sections. - Add a new item to the bottom of the list in a section. - If a duplicate item exists, discuss why the new item should replace it. - Check your spelling & grammar. diff --git a/readme.md b/readme.md index bac4a54..bd558eb 100644 --- a/readme.md +++ b/readme.md @@ -27,106 +27,127 @@ An **unofficial** curated list of resources for Amp, an AI coding agent by Sourc ## Contents -- [Awesome Amp Code](#awesome-amp-code) - - [Contents](#contents) - - [AGENTS.md](#agentsmd) - - [Built with Amp](#built-with-amp) - - [Amp Integrations](#amp-integrations) - - [Amp CLI](#amp-cli) - - [Integration with Common CLI Tools](#integration-with-common-cli-tools) - - [ps aux](#ps-aux) - - [whois](#whois) - - [curl](#curl) - - [npm](#npm) - - [Official Amp Links](#official-amp-links) - - [Contributing](#contributing) - - [Contributors](#contributors) +- [Official Resources](#official-resources) +- [Agent Files & Context](#agent-files--context) +- [MCP Servers](#mcp-servers) +- [Projects & Tools](#projects--tools) +- [Editor & IDE Integrations](#editor--ide-integrations) +- [CLI Usage](#cli-usage) +- [Security & Best Practices](#security--best-practices) +- [Contributing](#contributing) -### AGENTS.md +### Official Resources -- [LangGraph](https://sourcegraph.com/github.com/langchain-ai/langgraph/-/blob/AGENTS.md) -- [Sink](https://sourcegraph.com/github.com/ccbikai/Sink/-/blob/AGENT.md) -- [Zoekt](https://sourcegraph.com/github.com/sourcegraph/zoekt/-/blob/AGENT.md) -- [Ultimate MCP Client](https://github.com/Dicklesworthstone/ultimate_mcp_client/blob/main/AGENT.md) -- [MCP Advisor](https://sourcegraph.com/github.com/istarwyh/mcpadvisor/-/blob/AGENT.md) -- [Use MCP](https://sourcegraph.com/github.com/modelcontextprotocol/use-mcp/-/blob/AGENT.md) +- [Amp](https://ampcode.com) - Main Amp website. +- [Amp Owner's Manual](https://ampcode.com/manual) - Comprehensive official documentation covering installation, usage, and best practices. +- [Amp CLI](https://www.npmjs.com/package/@sourcegraph/amp) - Official CLI package on npm. +- [Amp for VS Code](https://marketplace.visualstudio.com/items?itemName=sourcegraph.amp) - Official VS Code extension. +- [Amp SDK](https://ampcode.com/manual/sdk) - Official SDK documentation for building on Amp. +- [Raising an Agent Podcast](https://ampcode.com/podcast) - Podcast featuring insights from the Amp team. +- [Amp 101 YouTube Playlist](https://www.youtube.com/playlist?list=PL6zLuuRVa1_hLpciEULtzC3g3u4NJ6TVz) - Official video tutorials. +- [How to Build an Agent](https://ampcode.com/how-to-build-an-agent) - Guide to building AI agents. +- [Amp Chronicle](https://ampcode.com/chronicle) - Official news and announcements. +- [Amp Status](https://ampcodestatus.com) - Service status page. +- [Amp on X](https://x.com/ampcode) - Official Twitter/X account. -### Built with Amp +### Agent Files & Context -- [Unofficial Amp CLI Documentation](https://github.com/jdorfman/awesome-amp-code/blob/main/docs/amp_cli_docs.md) - Comprehensive documentation for Amp CLI with examples and best practices. -- [MyScratchpad VS Code Extension](https://marketplace.visualstudio.com/items?itemName=jccoder.myscratchpad) - VS Code extension for global and workspace-specific scratch files. +AGENTS.md files provide context and instructions to AI coding agents about your codebase. They help agents understand project structure, coding standards, and specific requirements. + +**Examples of AGENTS.md in open source projects:** + +- [LangGraph](https://sourcegraph.com/github.com/langchain-ai/langgraph/-/blob/AGENTS.md) - LangChain's graph-based agent framework. +- [Zoekt](https://sourcegraph.com/github.com/sourcegraph/zoekt/-/blob/AGENT.md) - Fast code search by Sourcegraph. +- [Ultimate MCP Client](https://github.com/Dicklesworthstone/ultimate_mcp_client/blob/main/AGENT.md) - Comprehensive MCP client implementation. +- [MCP Advisor](https://sourcegraph.com/github.com/istarwyh/mcpadvisor/-/blob/AGENT.md) - MCP server advisor tool. +- [Use MCP](https://sourcegraph.com/github.com/modelcontextprotocol/use-mcp/-/blob/AGENT.md) - Official MCP usage examples. + +### MCP Servers + +Model Context Protocol (MCP) enables AI agents to interact with external tools and services. These MCP servers extend Amp's capabilities: + +- [llm-rules MCP](https://www.npmjs.com/package/llm-rules) - Access Cursor rules dynamically via MCP. +- [CleanShot MCP](https://github.com/jdorfman/cleanshot-mcp) - MCP server for CleanShot X screenshot and recording integration. +- [MCP Advisor](https://github.com/istarwyh/mcpadvisor) - Tool to help discover and configure MCP servers. +- [Ultimate MCP Client](https://github.com/Dicklesworthstone/ultimate_mcp_client) - Comprehensive MCP client for testing and debugging servers. +- [Use MCP](https://github.com/modelcontextprotocol/use-mcp) - Official examples and utilities for MCP usage. + +### Projects & Tools + +**Documentation & Guides:** + +- [Unofficial Amp CLI Documentation](https://github.com/lfglabs-dev/awesome-amp-code/blob/main/docs/amp_cli_docs.md) - Comprehensive documentation for Amp CLI with examples and best practices. +- [File-Based Amp Prompting Workflows](https://github.com/PriNova/amp-prompting-workflows) - Collection of file-based sub-agent orchestration workflows for Amp. + +**Development Tools:** + +- [Sandboxed.sh](https://github.com/Th0rgal/sandboxed.sh) - Self-hosted cloud orchestrator for AI coding agents with isolated Linux environments. - [Unofficial Amp Supervisor](https://github.com/ctrl-cheeb-del/manager) - TUI control panel for managing multiple Amp CLI instances in parallel. -- [llm-rules MCP](https://www.npmjs.com/package/llm-rules) - Model Context Protocol server for accessing Cursor rules dynamically. -- [amp.el](https://github.com/shaneikennedy/amp.el) - Emacs integration for Amp coding agent. -- [Remote Code](https://remote-code.com/) - Mobile coding platform that brings AI coding agents to your iPhone. -- [Sourcegraph Amp AUR](https://github.com/AnirudhKonduru/sourcegraph-amp-aur) - Arch Linux AUR package for Sourcegraph Amp. -- [PromptVault](https://hex.pm/packages/prompt_vault) - A library for managing prompts and templates in Elixir. [Watch stream](https://www.youtube.com/live/ojaoe3h8hXA?feature=share). -- [Unofficial Amp Owner's Manual](https://superpromptor.com/amp-owners-manual/) - Comprehensive guide to getting the most out of Amp coding agent. -- [Sourcegraph Chrome Extension](https://chromewebstore.google.com/detail/sourcegraph/dgjhfomjieaadpoljlnidmbg) - Chrome extension for code search and navigation. -- [CircuitPython Deploy](https://github.com/shantanugoel/circuitpython-deploy) - CircuitPython deployment tool. -- [File-Based Amp Prompting Workflows](https://github.com/PriNova/amp-prompting-workflows) - Comprehensive collection of file-based sub-agent orchestration workflows for Amp with persistent document-based communication. +- [Conductor](https://x.com/charliebholtz/status/1963345520543633742) - Run a bunch of Amps in parallel. - [Amp Code Review CI](https://github.com/madhukarkumar/amp-code-review-ci) - Continuous integration tool for automated code reviews using Amp. +- [Tokscale](https://github.com/junhoyeo/tokscale) - CLI tool for tracking token usage from AmpCode and other coding agents. +- [Sniff](https://github.com/conikeec/sniff) - Misalignment detection in Vibe Coding loops. - [CodeForge](https://github.com/entrepeneur4lyf/CodeForge) - Golang Development tool built with Amp. -- [Quad Ops](https://trly.github.io/quad-ops/) - A lightweight GitOps framework for podman containers managed by Quadlet. -- [HTTPie Collection Viewer](https://httpie.bolaji.de/) - Upload and explore your HTTPie collections with style. -- [CleanShot MCP](https://github.com/jdorfman/cleanshot-mcp) - Model Context Protocol server for CleanShot X screenshot and recording. -- [SageMap](https://sagemap.netlify.app/) - Interactive belief mapping tool that transforms journal entries into visual networks revealing contradictions and connections in your thoughts. + +**Applications Built with Amp:** + - [Jazzberry AI](https://jazzberry.ai/) - The AI Bug Finder. -- [0.email](https://0.email/) - Zero is an AI-native email client that manages your inbox. -- [VT Chat](https://vtchat.io.vn/) - A minimal, privacy-first AI chat application with advanced AI capabilities. -- [Sniff](https://github.com/conikeec/sniff) - Misalignment detection in Vibe Coding loops. +- [0.email](https://0.email/) - AI-native email client that manages your inbox. +- [Remote Code](https://remote-code.com/) - Mobile coding platform that brings AI coding agents to your iPhone. +- [SageMap](https://sagemap.netlify.app/) - Interactive belief mapping tool for journal entries. +- [VT Chat](https://vtchat.io.vn/) - Privacy-first AI chat application. +- [HTTPie Collection Viewer](https://httpie.bolaji.de/) - Upload and explore your HTTPie collections. +- [Quad Ops](https://trly.github.io/quad-ops/) - Lightweight GitOps framework for podman containers. +- [PromptVault](https://hex.pm/packages/prompt_vault) - Library for managing prompts and templates in Elixir. +- [CircuitPython Deploy](https://github.com/shantanugoel/circuitpython-deploy) - CircuitPython deployment tool. -### Amp Integrations +**Browser & Misc:** + +- [Sourcegraph Chrome Extension](https://chromewebstore.google.com/detail/sourcegraph/dgjhfomjieaadpoljlnidmbg) - Chrome extension for code search and navigation. +- [Sourcegraph Amp AUR](https://github.com/AnirudhKonduru/sourcegraph-amp-aur) - Arch Linux AUR package for Sourcegraph Amp. + +### Editor & IDE Integrations -- [Amp Dash X](https://www.raycast.com/jdorfman/sourcegraph-amp-dash-x) - A Raycast extension for organizing and executing Amp Code prompts with the `-x` (execute) flag. -- [VibeKanban](https://www.vibekanban.com/) - CLI tool for managing your Kanban boards. -- [Conductor](https://x.com/charliebholtz/status/1963345520543633742) - Run a bunch of Amps in parallel. - [amp.nvim](https://github.com/sourcegraph/amp.nvim) - Official Neovim plugin for Amp coding agent. - [nvim-amp](https://github.com/aliou/nvim-amp) - Neovim plugin providing syntax highlighting and support for Amp permission and agent files. +- [amp.el](https://github.com/shaneikennedy/amp.el) - Emacs integration for Amp coding agent. - [Amp ACP](https://github.com/tao12345666333/amp-acp) - ACP adapter for Amp Code, enabling Amp to work in the Zed editor. -- [Tokscale](https://github.com/junhoyeo/tokscale) - A CLI tool for tracking token usage from AmpCode and other coding agents (OpenCode, Claude Code, Codex, Gemini CLI, Cursor IDE, and Factory Droid) - -### Amp CLI - -#### Integration with Common CLI Tools +- [MyScratchpad VS Code Extension](https://marketplace.visualstudio.com/items?itemName=jccoder.myscratchpad) - VS Code extension for global and workspace-specific scratch files. +- [Amp Dash X](https://www.raycast.com/jdorfman/sourcegraph-amp-dash-x) - Raycast extension for organizing and executing Amp Code prompts. +- [VibeKanban](https://www.vibekanban.com/) - CLI tool for managing your Kanban boards. -Amp CLI can be seamlessly integrated with other command-line tools to enhance your workflow. Use the `-x` flag for execute mode or pipe input directly: +### CLI Usage -##### ps aux +Amp CLI can be integrated with other command-line tools. Use the `-x` flag for execute mode or pipe input directly: ```bash +# Analyze processes ps aux > processes.txt | amp -x 'identify processes consuming the most resources in processes.txt' -``` - -##### whois -```bash +# Parse whois data whois example.com | amp -x 'organize and condense this whois information' -``` - -##### curl -```bash +# Analyze HTTP headers curl -Is https://github.com > headers.txt && amp -x 'analyze the http headers in headers.txt and determine the tech stack' -``` - -##### npm -```bash +# Check npm dependencies npm list --json | amp -x 'identify outdated or vulnerable dependencies' ``` -### Official Amp Links +### Security & Best Practices + +When using AI coding agents, consider these security aspects: + +- [Amp Security Reference](https://ampcode.com/security) - Official security documentation and guidelines. +- [Amp Permissions](https://ampcode.com/manual/permissions) - Control what actions the agent can perform. -- [Amp](https://ampcode.com) -- [Amp CLI](https://www.npmjs.com/package/@sourcegraph/amp) -- [Amp for VS Code](https://marketplace.visualstudio.com/items?itemName=sourcegraph.amp) -- [Raising an Agent Podcast](https://ampcode.com/podcast) -- [Amp on X](https://x.com/ampcode) -- [How to Build an Agent](https://ampcode.com/how-to-build-an-agent) -- [Amp 101 YouTube Playlist](https://www.youtube.com/playlist?list=PL6zLuuRVa1_hLpciEULtzC3g3u4NJ6TVz) +**Key recommendations:** +- Always review AI-generated code before committing +- Never include API keys or secrets in prompts or AGENTS.md files +- Consider running agents in isolated environments for sensitive projects +- Vet MCP servers before installation ### Contributing @@ -134,7 +155,7 @@ npm list --json | amp -x 'identify outdated or vulnerable dependencies' #### Contributors -[Thanks goes to these contributors](https://github.com/jdorfman/awesome-amp-code/graphs/contributors)! +[Thanks goes to these contributors](https://github.com/lfglabs-dev/awesome-amp-code/graphs/contributors)! ---