GitHub Actions Editor

An editor for GitHub Actions — a desktop GUI application for editing workflows with marketplace discovery and GitHub integration.

Report Bug · Request Feature

About The Project

A desktop GUI application for editing GitHub Actions workflows with marketplace discovery and GitHub integration.

• Visual Workflow Editor — Edit GitHub Actions workflows with a desktop-native UI

• Marketplace Discovery — Search and browse actions from the GitHub Marketplace with fuzzy search

• GitHub Authentication — Secure token storage using system keyring

• Intelligent Caching — Offline-capable with TTL-based caching for API responses

• Action Metadata — Auto-fetch and display action inputs, versions, and documentation

• Repository Integration — Discover secrets, variables, and repository settings

back to top

Installation

From Source

git clone https://github.com/dev-centr/github-actions-editor
cd github-actions-editor
cargo build --release
./target/release/github-actions-editor

Prerequisites

• Rust 1.75 or later

• On Windows: Visual Studio Build Tools

• On Linux: libssl-dev, pkg-config

• On macOS: Xcode Command Line Tools

back to top

Usage

Authentication

1. Launch the application

2. Enter your GitHub Personal Access Token

   • Create one at GitHub Settings → Developer settings → Personal access tokens

   • Required scopes: repo, read:org

3. Click "Connect"

Your token is stored securely in the system keyring (Windows Credential Manager, macOS Keychain, or Linux Secret Service).

Editing Workflows

1. Click "New Workflow" or open an existing .yml file

2. Use the sidebar to navigate jobs and steps

3. Click on a step to edit its configuration

4. Use the action browser (right panel) to search and insert marketplace actions

5. Save your workflow

Marketplace Discovery

The action browser supports:

• Fuzzy search — Type partial names to find actions

• Version selection — Choose from available tags (v4, v4.1.0, etc.)

• Metadata preview — See inputs, outputs, and descriptions before inserting

Development

cargo run
RUST_LOG=debug cargo run
cargo test
cargo clippy

Configuration

The application stores data in platform-specific directories:

Platform	Config Directory
Windows	%APPDATA%\amdphreak\github-actions-editor
macOS	~/Library/Application Support/com.amdphreak.github-actions-editor
Linux	~/.config/github-actions-editor

Cache data is stored separately in the platform’s cache directory.

back to top

Architecture

src/
├── main.rs           # Application entry point
├── app.rs            # Main application state and update logic
├── models/           # Data models (Workflow, Action, Marketplace)
├── github/           # GitHub API integration
├── cache/            # TTL-based caching
└── ui/               # Iced UI components

Contributing

Contributions are welcome! Please open an issue or pull request.

back to top

License

MIT License. See LICENSE file.

back to top

Acknowledgments

• Iced — Cross-platform GUI library for Rust

• Octocrab — GitHub API client

• fuzzy-matcher — Fuzzy string matching

Contact

DevCentr.org — support@devcentr.org

• Project: https://github.com/dev-centr/github-actions-editor

• Site: https://devcentr.org

back to top