https://github.com/atuinsh/desktop
📖 Runbooks that run
https://github.com/atuinsh/desktop
Last synced: 28 days ago
JSON representation
📖 Runbooks that run
- Host: GitHub
- URL: https://github.com/atuinsh/desktop
- Owner: atuinsh
- License: apache-2.0
- Created: 2025-06-06T17:36:29.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-10-06T21:00:52.000Z (about 1 month ago)
- Last Synced: 2025-10-06T22:11:59.151Z (about 1 month ago)
- Language: TypeScript
- Homepage: https://atuin.sh
- Size: 30.5 MB
- Stars: 1,313
- Watchers: 8
- Forks: 35
- Open Issues: 54
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Cla: CLA.md
Awesome Lists containing this project
- awesome-repositories - atuinsh/desktop - 📖 Runbooks that run (TypeScript)
- definitive-opensource - Atuin Desktop
README
Atuin Desktop
Runbooks that Run. A local-first, executable runbook editor for real terminal workflows. Atuin Desktop looks like a doc, but runs like your terminal.
download | documentation | hub | discord
## 🚀 Open Beta
Atuin Desktop is currently in **open beta**. We're actively collecting feedback and improving the experience based on real-world usage.
Read the [announcement post](https://blog.atuin.sh/atuin-desktop-open-source/)
## What is Atuin Desktop?
Most infrastructure is held together by five commands someone remembers when things go wrong. Documentation is out of date (if it exists at all), and the real answers are buried in Slack threads, rotting in Notion, or trapped in someone's shell history.
Atuin Desktop solves this by creating **executable runbooks** that bridge the gap between documentation and automation:
- **Kill context switching**: Chain shell commands, database queries, and HTTP requests in one place
- **Docs that don't rot**: Execute directly and stay relevant
- **Reusable automation**: Dynamic runbooks with Jinja-style templating
- **Instant recall**: Autocomplete from your real shell history
- **Local-first, CRDT-powered**: If it runs in your terminal, it runs in a runbook
- **Sync and share**: Keep runbooks up to date across devices and teams with Atuin Hub
## Key Features
### 🔧 Embedded Execution
- Terminal blocks that run directly in the interface
- Database clients for live queries
- Prometheus charts and monitoring integration
### 📚 Living Documentation
- Runbooks that run
- No more copy-pasting from outdated docs
- Real workflows that teams can actually use
### 🔄 Dynamic Templating
- Jinja-style templating for reusable logic
- Variable substitution and conditional logic
- Parameterized workflows for different environments
### 🏛️ Local-First Architecture
- CRDT-powered collaboration
- Works offline, syncs when connected
## Use Cases
Teams are already using Atuin Desktop for:
- **Release Management**: Automated release checklists that actually run
- **Infrastructure Migration**: Safe, repeatable migration workflows
- **Environment Management**: Spinning up staging and production with confidence
- **Database Operations**: Collaborative live query management
- **Incident Response**: Runbooks for when things break
## Getting Started
1. Download a package for your platform [on our releases page](https://github.com/atuinsh/desktop/releases)
2. Sign up for an account [on Atuin Hub](https://hub.atuin.sh/)
3. [Log into Atuin Desktop](https://man.atuin.sh/hub/getting-started/) and create your first runbook
## Feedback & Support
We're actively seeking feedback during our beta phase! Please use this repository to:
### 🐛 Report Issues
- Found a bug? [Open an issue](../../issues/new?template=bug_report.md)
- Include your OS, Atuin Desktop version, and steps to reproduce
### 💡 Request Features
- Have an idea? [Submit a feature request](../../issues/new?template=feature_request.md)
- Tell us about your workflow and how Atuin Desktop could better support it
### 💬 General Discussion
Questions about usage? [Start a discussion](https://forum.atuin.sh)
## Roadmap
### Coming Soon
- **Enhanced Integrations**: More database clients, monitoring tools, and APIs
- **History-to-Runbook**: Generate runbooks automatically from your shell history
## Community
- **Blog**: [blog.atuin.sh](https://blog.atuin.sh)
- **Discord**: [Join our community](https://discord.gg/Fq8bJSKPHh)
- **Twitter**: [@atuinsh](https://twitter.com/atuinsh)
- **Bluesky**: [@atuin.sh](https://bsky.app/profile/atuin.sh)
- **Website**: [atuin.sh](https://atuin.sh)
## Related Projects
- **[Atuin CLI](https://github.com/atuinsh/atuin)**: Magical shell history with sync, search, and stats
## License
Copyright 2025 Atuin, Inc
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.