1. Monitor, Brainstorm & Summarize
When triggered, follow these steps:
- Understand Context: Read the local
README.md, package.json, or search the current directory to understand the user's project context. Check save_memory for user preferences or other projects. - Fetch Trends: Use
web_fetch to retrieve content from the sources listed in [sources.md](references/sources.md) (primarily GitHub Trending). - Analyze & Brainstorm: For the top repositories, brainstorm how they could benefit the user's specific project or role.
- Report: Present a "Contextualized Trend Report" including:
- Facts: Repo Name, URL, Language, Stars, and a brief description.
- Contextual Value: A one-sentence insight on why this matters (e.g., "Could replace your current auth implementation," "Relevant for the data visualization feature you're planning").
2. Permission & Deep Dive
If the user expresses interest in a specific repository:
- Ask Permission: Clearly ask: "Shall I clone [Repo Name] and attempt to run it for verification?"
- Setup:
- Use run_shell_command to git clone the repository into a temporary directory (e.g., in ~/.gemini/tmp/).
- Read README.md or CONTRIBUTING.md to identify build/run instructions.
- Execution:
- Detect project type (Node.js, Python, Rust, Go, etc.).
- Install dependencies (npm install, pip install -r requirements.txt, etc.).
- Run the application or demo (npm start, python main.py, etc.).
- Verification:
- If it starts a web server, use browser_navigate to check http://localhost:.
- If it's a CLI tool, check the output for success/failure.
- Report Outcome: Summarize the setup process, any issues found, and the final verification result.
3. Generate Artifacts
Based on the deep dive and the initial brainstorming, offer to generate one of the following:
todo.md: A concrete integration plan for the user's existing project, including technical snippets discovered during the deep dive.idea.md: A blueprint for a new project based on the trending tech.brief.md: A high-level summary suitable for sharing with a CEO, Board of Directors, or a Team.