Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Go library for Alfred 3 + 4 workflows
| Date | Stars |
|---|---|
| 2026-07-24 | 877 |
| 2026-07-25 | 877 |
| 2026-07-28 | 877 |
| 2026-07-30 | 877 |
| 2026-08-06 | 877 |
Today
— stars today
This week
— stars this week
This month
— stars this month
Momentum
0.0
growth rate 0.00%/day
<div align="center">
<img src="https://raw.githubusercontent.com/deanishe/awgo/master/Icon.png" alt="AwGo Logo" title="AwGo Logo">
</div>
# AwGo — A Go library for Alfred workflows #
[![Build Status][ghaction-badge]][ghaction-link]
[![Go Report Card][goreport-badge]][goreport-link]
[![Coverage Status][coveralls-badge]][coveralls-link]
[![Go Reference][godoc-badge]][godoc-link]
<!--
[![Build Status][azure-badge]][azure-link]
[![Build Status][travis-badge]][travis-link]
[![Codacy Quality][codacy-badge-quality]][codacy-link]
[![Codacy coverage][codacy-badge-coverage]][codacy-link]
[![Codecov coverage][codecov-badge]][codecov-link]
-->
Full-featured library to build lightning-fast workflows in a jiffy.
- [Features](#features)
- [Installation & usage](#installation--usage)
- [Documentation](#documentation)
- [Requirements](#requirements)
- [Development](#development)
- [Licensing & thanks](#licensing--thanks)
## Features ##
- Full support for Alfred 3 & 4
- Bi-directional interface to [workflow's config][config]
- Fluent API for generating [Script Filter JSON][feedback]
- [Fuzzy sorting/filtering][fuzzy]
- [Simple, powerful API][cache-api] for [caching/saving workflow data][cache]
- Keychain API to [securely store (and sync) sensitive data][keychain]
- Helpers to [easily run scripts and script code][scripts]
- Workflow [update API][update] with built-in support for [GitHub][update-github] & [Gitea][update-gitea]
- [Pre-configured logging][logging] for easier debugging, with a rotated log file
- [Catches panics, logs stack trace and shows user an error message][run]
- ["Magic" queries/actions][magic] for simplified development and user support
- macOS [system icons][icons]
## Installation & usage ##
Install AwGo with:
```sh
go get -u github.com/deanishe/awgo
```
Typically, you'd call your program's main entry point via `Workflow.Run()`.
This way, the library will rescue any panic, log the stack trace and show
an error message to the user in Alfred.
program.go:
```go
package main
// Package is called aw
import "github.com/deanishe/awgo"
// Workflow is the main API
var wf *aw.Workflow
func init() {
// Create a new Workflow using default settings.
// Critical settings are provided by Alfred via environment variables,
// so this *will* die in flames if not run in an Alfred-like environment.
wf = aw.New()
}
// Your workflow starts here
func run() {
// Add a "Script Filter" result
wf.NewItem("First result!")
// Send results to Alfred
wf.SendFeedback()
}
func main() {
// Wrap your entry point with Run() to catch and log panics and
// show an error in Alfred instead of silently dying
wf.Run(run)
}
```
In the Script Filter's Script box (Language = /bin/bash with input as
argv):
```sh
./program "$1"
```
## Documentation ##
Read the docs [on pkg.go.dev][godoc].
Check out the [example workflows][examples-code] ([docs][examples-docs]), which
show how to use AwGo. Use one as a template to get your own workflow up and
running quickly.
## Requirements ##
The library (and therefore the unit tests) rely on being run in a minimally
Alfred-like environment, as they pull configuration options from the environment
variables set by Alfred.
This means that if you want to run AwGo-based code outside Alfred, e.g. in your
shell, you must set at least the following environment variables to meaningful
values, or the library will panic:
- `alfred_workflow_bundleid`
- `alfred_workflow_cache`
- `alfred_workflow_data`
And if you're using the update API, also:
- `alfred_workflow_version`
- `alfred_version` (not needed for Alfred 4+)
## Development ##
To create a sufficiently Alfred-like environment, you can `source` the `env.sh`
script in the project root or run unit tests via the `run-tests.sh` script
(which also sets up an appropriate environment before calling `go test`).
## Licensing & thanks ##
This library is released under the [MIT licence][licence]. It was built with
[neExcerpt of 7,082 characters
Read on GitHub
Dean Jackson · Germany
314
1
Would you bet a product on this? Bounded 0–100 and slow moving.
matched fp:7b25484092d68b2f, topic:workflow