https://github.com/steveshi/essays
Native macOS client for the Memos.
https://github.com/steveshi/essays
macos-app memos memos-client
Last synced: 13 days ago
JSON representation
Native macOS client for the Memos.
- Host: GitHub
- URL: https://github.com/steveshi/essays
- Owner: SteveShi
- License: mpl-2.0
- Created: 2026-02-24T23:34:59.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-30T22:19:55.000Z (13 days ago)
- Last Synced: 2026-05-30T22:20:57.388Z (13 days ago)
- Topics: macos-app, memos, memos-client
- Language: Swift
- Homepage: https://essays-website.vercel.app
- Size: 4.09 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Essays
**Essays** is a native macOS client for the [Memos](https://usememos.com) self-hosted note-taking service. It provides a seamless and lightweight experience for capturing thoughts, logging daily activities, and organizing inspiration.
## Features
- π΄ **Offline-First Architecture**: Redesigned sync layer allowing you to compose, edit, and delete memos without an internet connection.
- π¬ **Sync Queue View**: Monitor pending local changes and background synchronization status directly from the sidebar.
- π± **Universal App**: Full native support for macOS, iPadOS, and iOS, providing a seamless experience across all your devices.
- π **Three-Column Navigation**: A responsive, standard `NavigationSplitView` ensuring optimal use of screen real estate (Sidebar, Timeline, and Details).
- β¨ **Premium Native UI**: A "LiquidGlass" aesthetic with glassmorphism, thin materials, and subtle micro-animations.
- π€ **Apple AI Assistant**: Integrated Foundation Models for on-device text processing and intelligence.
- π **Quick Capture & Global Shortcuts**: Record thoughts instantly from anywhere on your Mac using customizable global hotkeys.
- πΌοΈ **Attachments Gallery**: A dedicated grid view in the sidebar to easily browse all your image memos.
- π **Rich Media Previews**: Native Apple Quick Look for image attachments and interactive MapKit popovers for location tags.
- π
**Interactive Calendar**: A reactive Monthly Calendar directly in the sidebar to filter your daily logs.
- π **Timeline View**: A beautifully organized chronological feed of your memos, grouped by date.
- π **Fully Localized**: Complete support for English and Simplified Chinese.
- π **Privacy First**: Direct connection to your self-hosted Memos server via Access Tokens.
## Screenshots
## Apple AI Assistant
Leverage the power of Apple's on-device Foundation Models to enhance your brainstorming and note-taking:
- β¨ **Summarize**: Generate concise summaries of long memos.
- βοΈ **Improve Writing**: Polish grammar, tone, and clarity.
- π **Expand**: Elaborate on brief ideas with more detail.
- π·οΈ **Generate Tags**: Automatically suggest relevant tags.
- π‘ **Related Ideas**: Unlock new perspectives with AI-generated connections.
All AI processing happens **locally on your Mac**, ensuring your thoughts and data remain completely private.
## Installation
### Direct Download
Download the latest `.dmg` or `.app` from the [Releases](https://github.com/SteveShi/Essays/releases) page.
### Homebrew
Install via Homebrew tap:
```bash
brew tap SteveShi/tap
brew install --cask essays
```
### Build from Source
1. Clone the repository.
2. Install [XcodeGen](https://github.com/yonaskolb/XcodeGen) (`brew install xcodegen`).
3. Run `xcodegen generate` in the project root.
4. Open `Essays.xcodeproj` and run.
## Configuration
On the first launch, you will be prompted to enter:
- **Server URL**: The address of your Memos instance (e.g., `https://memos.example.com`).
- **Access Token**: Your personal access token from Memos settings.
## License
This project is licensed under the [Mozilla Public License 2.0](LICENSE).
---
[View Chinese Version / εζ’θ³δΈζη](README.zh-CN.md)