Skip to content
Back to search

hylo

Hylo: AI-native note-taking app compatible with Obsidian. AI agents organize and help you use your notes.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/skoowoo/hylo with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/skoowoo/hylo'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/skoowoo--hylo/badge.svg)](/listings/skoowoo--hylo)

HTML

<a href="/listings/skoowoo--hylo"><img src="/api/listings/skoowoo--hylo/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

> **For most users:** install the Desktop App and the Clip extension — that's it. The Desktop App detects the CLI on first launch and offers one-click installation if it is not found. A standalone Server & CLI installation is only needed if you want to deploy Hylo on a remote or headless host.

💻 Desktop App

1. Download the latest `.dmg` file from the [Latest Release](https://github.com/skoowoo/hylo/releases/latest) page 2. Open the dmg and drag Hylo into your Applications folder 3. On first launch, macOS may block the app since it is signed but not notarized by Apple

**Fix:** Go to **System Settings → Privacy & Security**, scroll down to find the blocked app notice, and click **Open Anyway**

4. The Desktop App installs the `hylo` CLI to `~/.local/bin/hylo`. Add this to your shell profile so agents can use it:

   # zsh — add to ~/.zshrc or ~/.zprofile
   export PATH="$HOME/.local/bin:$PATH"

   # bash — add to ~/.bash_profile or ~/.bashrc
   export PATH="$HOME/.local/bin:$PATH"

Restart your terminal (or run `source ~/.zshrc` / `source ~/.bash_profile`) afterward.

🧩 Browser Extension (Clip)

1. Download the latest `hylo-clip-*.zip` from the [Latest Release](https://github.com/skoowoo/hylo/releases/latest) page 2. Unzip the file 3. Open Chrome or Edge and go to `chrome://extensions/` 4. Enable **Developer mode** in the top-right corner 5. Click **Load unpacked** and select the unzipped folder 6. The extension is now installed and visible in your browser toolbar

⌨️ Server & CLI

Run the following command to install the Hylo server and CLI:

curl -sL https://raw.githubusercontent.com/skoowoo/hylo/main/install-cli.sh | sh

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 80 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Hylo
  2. **Your notes. Your context. Your AI.**
  3. Hylo is a notes app with a Personal AI built in. You write; AI compiles your notes into context about you; your own AI uses that context to work for you. All your data stays on your own machine.
  4. [中文文档](./README_ZH.md)
  5. ![Hylo](./docs/assets/hero.jpeg)
  6. ## Your notes
  7. A complete notes app, and every note file belongs to you.
  8. - **Write and capture.** A WYSIWYG Markdown editor, Shorts for passing thoughts, instant search, and a browser extension that saves any page as Markdown.
  9. - **No lock-in.** Share the same vault with Obsidian, open it in any editor, and if you ever leave Hylo, your notes leave with you unchanged.
  10. ## Your context
  11. Scattered notes are hard for an AI to use. Hylo has AI compile them into structured context that it can actually work with:
  12. - **Knowledge wiki.** Notes and web clips become linked knowledge units under `/_knowledge/`: a map of your knowledge, as an LLM wiki.
  13. - **Personal memory.** Who you are, what you're after, what you believe, the people around you, what you're doing now, how you write. Kept in `/_memory/` and updated as you write.
  14. Personal context is the most private data you have. Here it is Markdown in your own vault: you can read it, correct it, and no AI vendor keeps it for you.
  15. ## Your AI
  16. A personal AI that knows you and works for you, not for a platform.
  17. - **Knows you.** Every conversation starts with your memory and knowledge, so you never have to explain yourself again.
  18. - **Works for you.** Bots act on their own when notes arrive or on a schedule: compiling what you clip, updating your memory, bringing old notes back. Add skills and they go further, like picking the news you'll care about. Talk to them in the app or from WeChat, Discord and Telegram.
  19. - **Not tied to a vendor.** Hylo drives the agent CLI you choose (**Claude Code, Codex, OpenCode, Cursor Agent, GitHub Copilot CLI or Pi**), and switching is a setting. Run the server on your own machine or cloud instance and it stays on with your laptop closed.
  20. ## Get started
  21. 1. **Desktop app.** Download the `.dmg` from [Releases](https://github.com/skoowoo/hylo/releases/latest). If macOS blocks it, go to **System Settings → Privacy & Security → Open Anyway**. The app installs the `hylo` CLI to `~/.local/bin`; add that to your `PATH`:
  22. ```sh
  23. export PATH="$HOME/.local/bin:$PATH"
  24. ```
  25. 2. **Onboarding** creates the main **Hylo** bot on your agent CLI, ready to compile clips and update your memory.
  26. 3. **Clip extension** (optional). Download `hylo-clip-*.zip` from the same page, unzip it, and load it in `chrome://extensions/` with Developer mode on.
  27. 4. **Always on** (optional). Install the server on another host and follow [Remote Deployment](./docs/remote-deployment.md):
  28. ```sh
  29. curl -sL https://raw.githubusercontent.com/skoowoo/hylo/main/install-cli.sh | sh
  30. ```
  31. ### Use an existing Obsidian vault
  32. Pick the vault folder under **Settings → Server → Config → Vault** and save. Hylo initializes it automatically, adding a `.hylo/` folder and indexing your notes. Nothing else in the vault changes, and Obsidian keeps working on it as before.
  33. ## Before you start
  34. - **Keep folders flat.** One level of category folders works best.
  35. - **Keep filenames unique.** Wikilinks `[[name]]` point at filenames, not paths.
  36. - **`_` folders belong to Hylo.** `_knowledge/`, `_memory/`, `_shorts/` and similar are system folders; don't start your own folder names with `_`.
  37. - **Bring your own agent.** Install at least one of the supported agent CLIs first; Pi is recommended.
  38. ## Docs
  39. - [Bots](./docs/bots.md): triggers, the Hylo bot, WeChat / Discord / Telegram, customizing prompts
  40. - [Context](./docs/context.md): how the knowledge wiki and personal memory are built
  41. - [Skills](./docs/skills.md): built-in skills, adding more from GitHub
  42. - [Remote Deployment](./docs/remote-deployment.md): running Hylo 24/7 behind HTTPS
  43. ## Architecture
  44. Hylo Server is one self-contained Go binary with SQLite and a full-text index built in. The desktop app, CLI, chat channels and Clip extension all talk to it over HTTP, the same way whether it runs locally or on a remote host.
  45. ```
  46. Desktop App CLI WeChat / Discord / Telegram Clip
  47. └─────────┴──────────────┬──────────────────┘
  48. ▼
  49. Hylo Server
  50. ┌──────────────┬─────────┴────┬──────────────┐
  51. Markdown files SQLite Full-text index Agent CLIs
  52. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.