# AI use cases for Graybox (Aaryanverma/graybox)

Repo: [Aaryanverma/graybox](https://github.com/Aaryanverma/graybox) | Use cases: 4 | Page: https://dedupedai.com/use-cases/aaryanverma-graybox/

Gray Box is a local-first command-line tool that saves your notes as Markdown, organizes them into linked wiki pages with an LLM, and answers questions with cited sources.

This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL.

- Turn meeting notes into linked wiki pages: https://dedupedai.com/use-cases/aaryanverma-graybox/turn-meeting-notes-into-linked-wiki-pages/
- Ask questions over your notes and get cited answers: https://dedupedai.com/use-cases/aaryanverma-graybox/ask-questions-over-your-notes-with-citations/
- Keep work and personal memory in separate workspaces: https://dedupedai.com/use-cases/aaryanverma-graybox/separate-work-and-personal-memory-workspaces/
- Build a private memory for birthdays, books, and visits: https://dedupedai.com/use-cases/aaryanverma-graybox/build-a-private-life-admin-memory/

## How to turn meeting notes into linked wiki pages with Graybox

Repo: [Aaryanverma/graybox](https://github.com/Aaryanverma/graybox) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Paste raw meeting notes and get people, projects, tasks, and decisions as cross-linked Markdown pages.

**Who it is for:** A team lead or project owner who takes quick notes in meetings and wants owners, due dates, and decisions tracked without manual filing.

**The problem:** Decisions, owners, and deadlines from meetings get lost in scattered notes and chat threads.

**The outcome:** A set of wiki pages for the people, projects, tasks, and decisions in the notes, each linked to its original capture.

### Steps

1. Install the tool with `pip install graybox` and set your LLM API key in an .env file or as GRAYBOX_LLM_API_KEY.
2. Copy the config file into your working directory and update it with your LLM and workspace details.
3. Capture the meeting notes with `graybox capture "<meeting notes>"`. (inferred, check the README)
4. Preview the result with `graybox organize --dry-run`, then run `graybox organize` to write the pages.
5. Review the generated pages with `graybox pages`.

### Prompt to paste into your agent

```text
Use the Aaryanverma/graybox repo to capture the notes in <notes-file> with `graybox capture`, then run `graybox organize --dry-run` and `graybox organize`. Expected output: a list of new wiki pages for people, projects, tasks, and decisions. Verify that `graybox pages` lists the pages and that each one links back to its source capture.
```

### Caveat

Organization runs through the LLM you configure, so extraction quality depends on that model and the page results should be reviewed.

Risk, credentials: Meeting notes often contain names and work details, and the LLM API key must be kept out of shared or synced folders.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/aaryanverma-graybox/turn-meeting-notes-into-linked-wiki-pages/

## How to ask questions over your notes and get cited answers with Graybox

Repo: [Aaryanverma/graybox](https://github.com/Aaryanverma/graybox) | Difficulty: Beginner | Time: 15 minutes | Basis: From the README

Query everything you captured and receive an answer that cites the specific note or page it used.

**Who it is for:** A knowledge worker or student who has many captured notes and needs to recall a fact with proof of where it came from.

**The problem:** Searching old notes by hand is slow, and an answer without a source is hard to trust.

**The outcome:** A grounded answer with inline citations such as [person/aaryan], or an honest statement that nothing relevant was found.

### Steps

1. Capture notes with `graybox capture "<note text>"` as they come up. (inferred, check the README)
2. Run `graybox organize` to turn the captures into wiki pages.
3. Ask a question with `graybox ask "<your question>"`. (inferred, check the README)
4. Continue the conversation with `graybox chat` if you have follow-up questions.

### Prompt to paste into your agent

```text
Use the Aaryanverma/graybox repo to answer <question> with `graybox ask`. Expected output: an answer with inline citations to wiki pages or inbox notes. Verify that every cited source exists under `graybox pages` and that the answer does not claim facts beyond those sources.
```

### Caveat

Answers are grounded only in captured notes, and when the wiki has no strong match the tool may fall back to unorganized inbox captures with a warning.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/aaryanverma-graybox/ask-questions-over-your-notes-with-citations/

## How to keep work and personal memory in separate workspaces with Graybox

Repo: [Aaryanverma/graybox](https://github.com/Aaryanverma/graybox) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Create isolated workspaces so work and personal notes stay apart unless you search across both.

**Who it is for:** A person who uses one tool for both job knowledge and private life and does not want the two mixed together.

**The problem:** Unrelated work and personal notes can mix in one wiki and show up in each other's search results.

**The outcome:** Two isolated workspaces, with searches limited to the active one unless you explicitly search all of them.

### Steps

1. Create a second workspace with `graybox workspace-create work --description "Day job knowledge base"`.
2. Switch between workspaces with `graybox workspace-switch personal` or `graybox workspace-switch work`.
3. List your workspaces and see which one is active with `graybox workspace-list`.
4. Search every workspace at once with `graybox ask "<your question>" --all` when you need results from both. (inferred, check the README)

### Prompt to paste into your agent

```text
Use the Aaryanverma/graybox repo to create a workspace named <workspace-name> and switch to it. Expected output: the workspace appears in `graybox workspace-list` marked as active. Verify that a page captured in one workspace does not appear in `graybox pages` after switching to the other.
```

### Caveat

Graph expansion is skipped in --all mode, and there is no automatic sync between workspaces, so shared facts must be captured in each one.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/aaryanverma-graybox/separate-work-and-personal-memory-workspaces/

## How to build a private memory for birthdays, books, and visits with Graybox

Repo: [Aaryanverma/graybox](https://github.com/Aaryanverma/graybox) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Capture personal details like birthdays, book recommendations, and doctor notes into linked pages you can search.

**Who it is for:** An individual who wants a private place to remember friends' birthdays, recommended books, and notes from appointments.

**The problem:** Personal details and reminders are scattered across phone notes, texts, and paper, and are easy to forget.

**The outcome:** Linked pages for people, topics, and events from your personal captures, plus answers to questions about them.

### Steps

1. Capture personal notes with `graybox capture "<personal note>"`, such as a birthday or a book recommendation. (inferred, check the README)
2. Run `graybox organize --dry-run` to preview the pages, then `graybox organize` to write them.
3. Browse the resulting pages with `graybox pages`.
4. Ask about your captures with `graybox ask "<question>"`. (inferred, check the README)

### Prompt to paste into your agent

```text
Use the Aaryanverma/graybox repo to capture the personal notes in <notes-file> and run `graybox organize`. Expected output: wiki pages for the people, events, and topics in those notes. Verify that `graybox ask "<question>"` returns an answer that cites one of the new pages.
```

### Caveat

The README says the tool works for personal use, but its page types skew toward work, so personal pages may need manual review with `graybox pages`.

Risk, credentials: Health notes and personal details are sent to the LLM provider you configure during organize and ask, so use a self-hosted model if that is a concern.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/aaryanverma-graybox/build-a-private-life-admin-memory/
