Back to the catalog

daily-grind

A demo Gemini CLI extension that also bundles some MCP magic

Open source Open in the app JSON README (API)

About

A demo Gemini CLI extension that also bundles some MCP magic

Details

Kind
Plugins
Topic
AI, RAG & memory
Publisher
sapientcoffee
Origin
gemini
Category
ferramentas
Version
0.0.1
Stars
1
Last push
2025-10-30T00:52:25Z
Repository state
ativo
Language
TypeScript
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
sapientcoffee/daily-grind-extension

README

# daily-grind Gemini CLI Extension

**Your daily briefing of tech news, brewed just for you, right in your terminal.**

`daily-grind` is a fun, coffee-themed Gemini CLI extension that acts as a personal "news barista." It provides a single, simple command to fetch, consolidate, and intelligently summarize the latest updates from a user-defined list of sources.

This extension starts as a simple local tool and is designed to evolve into a powerful, shareable service that can query central data sources for release notes, turning your CLI into a smart, conversational research assistant.

---

## Getting Started

Follow these steps to get the `daily-grind` extension up and running on your local machine.

### Prerequisites

- [Node.js](https://nodejs.org/) (v18 or higher)
- [Gemini CLI](https://github.com/google/gemini-cli)

### Installation from GitHub

To install the `daily-grind` extension directly from its GitHub repository, run the following command:

```bash
gemini extensions install https://github.com/sapientcoffee/daily-grind-extension.git
```

This command will automatically handle cloning the repository, installing dependencies, and building the TypeScript code.

### Step 1: Install Dependencies

First, navigate to the extension's directory and install the required npm packages.

```bash
# From within the daily-grind-extension directory
npm install
```

### Step 2: Compile Your TypeScript

Now that the dependencies are installed, you need to compile the TypeScript code into JavaScript. The project is already configured with a build script for this.

```bash
# This runs the TypeScript compiler (tsc)
npm run build
```

This command will create a new `dist` folder containing your compiled `daily-grind.js` file. The `gemini-extension.json` manifest is already set up to look in this `dist` folder.

### Step 3: "Install" Your Local Extension

You're ready to register your extension with the main Gemini CLI. Since you are already inside the `daily-grind-extension` folder, you can just use `.` to specify the current directory.

```bash
# While still inside the ./daily-grind-extension directory
gemini extensions install .
```

You'll see a confirmation that the extension was installed successfully.

### Step 4: Run and Test Your New Tool!

You're all set! Just start the Gemini CLI.

```bash
gemini
```

When it loads, you should see a new line like `[daily-grind] ... started`, letting you know your extension's local server is running.

Now, test your tool with a prompt. For example, to test the `brew_suggestion` tool from Phase 1:

```
g! "I'm feeling really tired, what do you suggest?" @brew_suggestion(mood: 'tired')
```

Gemini will ask for permission to run your new tool. Once you approve, it will execute your code and provide a coffee-themed response!

---

## Feature Roadmap

This extension is being developed in phases:

- **Phase 1: The "Local Cafe" (v0.1)**
  - **Goal:** Establish local functionality and a delightful user experience.
  - **Features:** A fun "coffee suggestion" tool and a basic tool to read and summarize local text files.

- **Phase 2: The "Coffee Chain" (v1.0 - Core MVP)**
  - **Goal:** Deliver the core value by fetching and summarizing remote release notes from user-defined RSS/Atom feeds.
  - **Features:** A `fetch_daily_grind` tool and a `brew_me_a_summary` custom command.

- **Phase 3: The "Specialty Roaster" (v2.0 - Team & Power-User)**
  - **Goal:** Scale the solution for teams with advanced, data-driven queries.
  - **Features:** Integration with BigQuery for querying release notes by product name and deployment of the MCP server to a remote service like Google Cloud Run.

---

## Documentation

For a detailed overview of the product vision, roadmap, and technical specifications, please refer to our [Product Documentation](https://docs.google.com/document/d/1NoyTf3fJcOLf4mtb7-Y_FrWy4nTWlVsHo3W5ryTwWCQ/edit?tab=t.0#heading=h.c29qo317jze3).

More