https://github.com/flowexec/flow
Local developer automation platform that flows with you
https://github.com/flowexec/flow
cli-tool developer-platform go task-runner tui
Last synced: about 2 months ago
JSON representation
Local developer automation platform that flows with you
- Host: GitHub
- URL: https://github.com/flowexec/flow
- Owner: flowexec
- License: apache-2.0
- Created: 2023-07-30T02:52:13.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-12-26T21:24:51.000Z (3 months ago)
- Last Synced: 2025-12-28T05:43:54.192Z (3 months ago)
- Topics: cli-tool, developer-platform, go, task-runner, tui
- Language: Go
- Homepage: http://flowexec.io/
- Size: 5.42 MB
- Stars: 128
- Watchers: 3
- Forks: 5
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-go - flowexec/flow
README
flow is your local-first developer platform - organize automation across all your projects with built-in secrets, templates, and cross-project workflows.
Define workflows in YAML, browse auto-generated documentation, and run them anywhere.
---
## Quick Start
```bash
# Install
curl -sSL https://raw.githubusercontent.com/flowexec/flow/main/scripts/install.sh | bash
# Create your first workflow
flow workspace add my-project . --set
echo 'executables:
- verb: run
name: hello
exec:
cmd: echo "Hello from flow!"' > hello.flow
# Run it
flow sync
flow run hello
```
## Key Features
flow complements existing CLI tools by adding multi-project organization, built-in security, and visual discovery to your automation toolkit.
- **Workspace organization** - Group and manage workflows across multiple projects
- **Encrypted secret vaults** - Multiple backends (AES, Age, keyring, external tools)
- **Interactive discovery** - Browse, search, and filter workflows visually
- **Flexible execution** - Serial, parallel, conditional, and interactive workflows
- **Workflow generation** - Create projects and workflows from reusable templates
- **Composable workflows** - Reference and chain workflows within and across projects
- **Platform integrations** - GitHub Actions, AI assistants (MCP), and more
## Example Workflows
```yaml
# api.flow
executables:
- verb: deploy
name: staging
serial:
execs:
- cmd: npm run build
- cmd: docker build -t api:staging .
- ref: shared-tools/k8s:deploy-staging
- cmd: curl -f https://api-staging.example.com/health
- verb: backup
name: database
exec:
params:
- secretRef: database-url
envKey: DATABASE_URL
cmd: pg_dump $DATABASE_URL > backup-$(date +%Y%m%d).sql
```
```bash
# Run workflows
flow deploy staging
flow backup database
# Visual discovery
flow browse
```
## Documentation
**Complete documentation at [flowexec.io](https://flowexec.io)**
- [Installation](https://flowexec.io/installation) - Multiple installation methods
- [Quick Start](https://flowexec.io/quickstart) - Get up and running in 5 minutes
- [Core Concepts](https://flowexec.io/guide/concepts) - Understand workspaces, executables, and vaults
- [User Guides](https://flowexec.io/guide/README) - Comprehensive guides for all features
## Community
- [Discord Community](https://discord.gg/CtByNKNMxM) - Get help and share workflows
- [Issue Tracker](https://github.com/flowexec/flow/issues) - Report bugs and request features
- [Examples Repository](https://github.com/flowexec/examples) - Real-world workflow patterns
- [Contributing Guide](https://flowexec.io/development) - Help make flow better