# Tic

> FREE Floating, Stickies-style task lists for macOS.

- **Type:** MCP server
- **Install:** `agentstack add mcp-kasvith-tic`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kasvith](https://agentstack.voostack.com/s/kasvith)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kasvith](https://github.com/kasvith)
- **Source:** https://github.com/kasvith/tic
- **Website:** https://tic.kasvith.me

## Install

```sh
agentstack add mcp-kasvith-tic
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Tic
  Floating, Stickies-style task lists for macOS.

[](https://github.com/kasvith/tic/actions/workflows/ci.yml)
[](https://github.com/kasvith/tic/releases)
[](https://github.com/kasvith/tic/releases)

Tic keeps your lists **on the desktop** as floating sticky notes instead of buried behind a menu
bar click — glance at them, check things off, drag them around. Each note is its own checklist.

## Features

- **Floating sticky notes** — borderless, draggable, resizable panels; optional float-on-top and
  show-on-all-Spaces per note. Positions and state are remembered across launches.
- **Multiple lists** — create from the menu bar, **⌘N**, the in-note **+**, or the Dock menu.
  New lists are auto-named *List 1, List 2, …*
- **Rich tasks** — **subtasks** up to 3 levels (completing a parent completes its children),
  **multiline** notes (Shift-Return), and inline Markdown (`**bold**`, `*italic*`, `` `code` ``,
  `~~strike~~`, links). Tap to edit; drag to reorder, or drag right to nest.
- **Solid or Liquid-Glass** notes — per-note color themes, or a translucent material that shows
  the desktop through it.
- **Roll-up** — double-click a note's title bar to collapse it to just the header.
- **Raycast-style search palette** — a floating, centered command palette to search/open/delete
  any list, with keyboard navigation.
- **Launch at Login**, a custom menu-bar icon, and a native Dock identity.

## Requirements

macOS **14 (Sonoma)** or later.

## Install

1. Download `Tic-vX.Y.Z.zip` from the [latest release](https://github.com/kasvith/tic/releases),
   unzip it, and move **`Tic.app`** to `/Applications`.
2. Tic isn't code-signed/notarized (it's ad-hoc signed), so Gatekeeper will block it on first
   launch. Clear the quarantine flag:

   ```sh
   xattr -c /Applications/Tic.app
   ```

   Then open it normally. (Alternatively: right-click `Tic.app` → **Open** → **Open**.)
3. To have Tic open automatically, enable **Launch at Login** from its menu-bar menu.

## Build from source

Tic is a Swift Package — no `.xcodeproj` needed.

```sh
swift run                 # build + launch (dev)
swift build -c release    # release build
swift test                # run the test suite (Swift Testing)
./scripts/package.sh      # assemble dist/Tic.app (add --open to launch it)
open Package.swift        # edit in Xcode
```

## Usage

- The menu-bar icon lists your **recent lists** (with a **More Lists** submenu for the rest) and
  opens **Search Lists…**, **New List** (⌘N), and **Launch at Login**.
- Hover a note to reveal its controls: color, solid/glass, float-on-top, roll-up, **+** new list,
  and close. Click the title to rename; the bottom field adds tasks (Return keeps focus).
- Hover a task to reveal a **✕** (delete) and, below it, a **＋** line — click it to add a subtask
  nested under that row. An empty task you don't fill in disappears when you click away.

## Keyboard shortcuts

| Shortcut | Action |
| --- | --- |
| **Return** | Finish editing a task / add the typed task |
| **Shift-Return** (or **⌥ Return**) | New line within the same task |
| **Shift-Tab** | Make the task a subtask (nest one level deeper) |
| **⌃ Shift-Tab** | Un-nest a subtask (move it back out) |
| **⌘N** | New list |
| **Double-click** the title bar | Roll the note up / down |

You can also **drag a task** to reorder it, or **drag it right** to nest it — the drop indicator
shows where (and at what level) it will land. The relevant chord (`⇧⏎ line`, `⇧⇥ nest`) shows as a
tiny keycap hint right in the field while you're editing, so you don't have to memorise this table.

## Architecture

SwiftUI views hosted inside AppKit `NSPanel`s (the only way to get true desktop-sticky behavior),
backed by **SQLite via GRDB**. An `AppModel` coordinator bridges the menu bar to the window layer.
See [`CLAUDE.md`](CLAUDE.md) for the full breakdown.

**Stack:** Swift 6 · SwiftUI + AppKit · GRDB (SQLite) · `SMAppService` (login item).

## Development & releases

- **CI** (`.github/workflows/ci.yml`) builds, tests, and lints on every push/PR.
- **Changelog** is generated from [Conventional Commits](https://www.conventionalcommits.org)
  with [git-cliff](https://git-cliff.org) (`cliff.toml`) and kept in `CHANGELOG.md`.
- **Releases are tag-based:** push a `v*` tag and the release workflow builds `Tic.app`, generates
  release notes, and publishes a GitHub Release with the zipped app.

  ```sh
  git tag v0.1.0 && git push origin v0.1.0
  ```

Icon source art lives in [`Assets/`](Assets) (AppIcon / Flat / MenuBar).

## License

Released under the [MIT License](LICENSE). © 2026 Kasun Vithanage.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kasvith](https://github.com/kasvith)
- **Source:** [kasvith/tic](https://github.com/kasvith/tic)
- **License:** MIT
- **Homepage:** https://tic.kasvith.me

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-kasvith-tic
- Seller: https://agentstack.voostack.com/s/kasvith
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
