# Alfraid

- AI powered
- TODO list (advanced)
  - categories (house keeping, work, text friend & family)
  - timebox (5min, instant, 15min, 6h, 1d)
  - due date

# Stack

- MCP - interactions via agents
- Backend -> Just save a JSON file

# How To

## Prerequisites

1. [Install bun](https://bun.com/docs/installation#installing)

   ```bash
   brew install oven-sh/bun/bun
   ```

1. Install deps

   ```bash
   bun install
   ```

## Dev / Inspect the MCP server

The easiest way to run and check if MCP server works as expected is probably to use the "official" MCP inspector. Simply run:

```bash
bun run inspect
```

## Run config

In your MCP Host of choice, use the following config to connect to the server:

```json
{
  "mcpServers": {
    "alfraid": {
      "command": "bun",
      "args": ["run", "/path/to/alfraid/src/index.ts"] // make sure to update the path
    }
  }
}
```

Then, you should be able to ask your MCP Host to create and list TODOs.

# DevSteps

1. PoC
   - [x] server MCP up
   - [x] Connect in VSCode / Augment
2. A bit less dirty Local MCP server
   - [ ] Specify JSON file path
   - [ ] understand how MCP really do work
   - [ ] clarify and fix need for absolute path in config
3. Go Remote / Deploy
   - [ ] Maybe on [CloudFlare](https://developers.cloudflare.com/agents/guides/remote-mcp-server/)