Skip to content

Repository files navigation

Jisticle

The native macOS client for Gists because GitHub seems to have forgotten that they exist.

The goal is for Jisticle to be fast, intuitive, and for the UI to have been updated within the last decade. Hopefully it helps creating and managing your personal Gists.

✨ Features

  • 🔍 Lightning-Fast Search - Find any gist instantly with the fuzzy finder in the sidebar
  • 🎨 Syntax Highlighting - Full-featured code editor with language detection and beautiful highlighting
  • ✏️ Edit Gists Seamlessly - Modify files and save changes directly without leaving the app
  • Create New Gists - Quick creation with public/secret toggle and instant publishing
  • 🗑️ Delete with Confidence - Remove unwanted gists as needed
  • 📱 Modern Three-Pane Layout - Native macOS design that feels right at home
  • 💾 Smart Caching - Gists are cached locally for instant access even when you're offline
  • 🔐 Secure GitHub Authentication - Uses GitHub's Device Flow OAuth, no client secrets required
  • 🔒 Keychain Security - Your GitHub token is stored securely in macOS Keychain
  • 📍 Drag and Drop - Drag and drop file(s) from finder to add it to a gist
Main Window Editor View
Create New Gist Sidebar Search

🛠️ Getting Started

  1. Download the latest .dmg from the Releases page.
  2. Drag Jisticle.app to your Applications folder.
  3. Launch the app and sign in with your GitHub account.

Important

"Apple could not verify..."? Since Jisticle isn't signed with an Apple Developer certificate (yet!), macOS will block it by default.

To open it:

  1. Try to open Jisticle.app (it will fail with the warning).
  2. Open System Settings -> Privacy & Security.
  3. Scroll down to the Security section and click Open Anyway.
  4. Authenticate and click Open one last time.

Alternatively, run this in Terminal:

xattr -cr /Applications/Jisticle.app

📋 Requirements

  • macOS 14.0+
  • GitHub account

🏗️ Build from Source

# Clone the repository
git clone https://github.com/adamghill/jisticle.git
cd jisticle

# Install dependencies and build
swift package resolve
swift build

# Or use `just` (requires `just` to be installed)
just run

📦 Release Build

just build-release [version]

This creates Jisticle-macOS.dmg ready for distribution.

🤝 Contributing

Have an idea for Jisticle? Open a PR! ❤️

📜 License

MIT

About

The native macOS client for GitHub Gists

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages