Automate Your GitHub Workflows with Floci
Ever feel like you're doing the same manual tasks in your GitHub repos over and over? Updating labels, closing stale issues, or managing pull requests can become a real time sink. What if you could automate those repetitive actions without writing a single line of YAML for GitHub Actions or spinning up a dedicated server? That's the itch Floci aims to scratch.
It's a lightweight, serverless automation tool that listens to events in your repositories and performs actions for you. Think of it as a simple, focused automation buddy for your GitHub projects.
What It Does
Floci is a GitHub App that you install on your repositories. Once installed, you configure "flows" – these are essentially rules that say, "When this event happens, do that action."
For example, you can create a flow that automatically adds a needs-triage label to every newly opened issue. Or one that posts a welcome comment on a first-time contributor's pull request. The actions are triggered by common GitHub webhooks like issues, pull_request, and discussion events.
Why It's Cool
The clever part is the simplicity. Floci's power comes from its straightforward configuration. You define your automation logic in a simple floci.json file placed in your repository. This keeps your automation co-located with your code, version-controlled, and easy to understand.
Here’s a taste of what a flow looks like in that config:
{ "flows": [ { "name": "Label New Issues", "on": "issues.opened", "actions": [ { "type": "add-label", "label": "needs-triage" } ] } ]
}
No complex CI/CD pipeline syntax. It's declarative and gets right to the point. This makes it incredibly accessible for automating small to medium tasks that don't require the full power and complexity of a CI system.
Key Use Cases:
- Auto-labeling issues and PRs based on title, content, or author.
- Sending automated comments (think welcome messages or reminders).
- Managing stale issues or discussions.
- Synchronizing labels or milestones across repositories.
- Basic project board management.
How to Try It
Getting started is pretty straightforward:
- Install the GitHub App: Head over to the Floci GitHub App page and install it on your personal account or organization. Y