AEduardo-dev/flk

Flakes development environments management tool

Source code at GitHub https://aeduardo-dev.github.io/flk/

{
  "createdAt": "2025-10-24T09:55:00Z",
  "defaultBranch": "main",
  "description": "Flakes development environments management tool",
  "fullName": "AEduardo-dev/flk",
  "homepage": "https://aeduardo-dev.github.io/flk/",
  "language": "Rust",
  "name": "flk",
  "pushedAt": "2026-03-21T09:41:10Z",
  "stargazersCount": 8,
  "topics": [],
  "updatedAt": "2026-03-04T16:28:11Z",
  "url": "https://github.com/AEduardo-dev/flk"
}

flk 🚀

A modern CLI tool for managing Nix flake development environments with the simplicity of Devbox

flk makes managing Nix flakes feel like using a package manager. No more manually editing flake.nix files — just use simple commands to add packages, create custom shell commands, and manage your development environment.

✨ Features

🎯 Smart Initialization — Auto-detects your project type (Rust, Python, Node.js, Go)
📦 Easy Package Management — Add/remove packages, pin specific versions
⚡ Custom Shell Commands — Define reusable commands for your workflow
🌍 Environment Variables — Manage per-project variables through the CLI
👤 Multi-Profile Support — Maintain separate configurations within one project
🔒 Lock File Management — Backup, preview, and restore your flake.lock
🐳 Container Export — Export environments to Docker, Podman, or JSON
🔄 Hot Reload — Shell hooks for instant refresh and switch between profiles

⚡ Quick Start

cargo install flk          # install via cargo (or see table below)

flk init                   # scaffold a flake (auto-detects language)
flk add ripgrep            # add a package
flk cmd add test "cargo test --all"
flk env add DB_URL "postgres://localhost/dev"
flk activate               # enter the dev shell

See the Getting Started guide for a full walkthrough.

📦 Installation

Prerequisites: Nix with flakes enabled — recommended via Lix or the Determinate installer.

Method	Command
Cargo	`cargo install flk`
Nix (run)	`nix run github:AEduardo-dev/flk#flk`
Nix (install)	`nix profile install github:AEduardo-dev/flk#flk`
From source	`git clone … && cd flk && cargo install --path .`
Binaries	GitHub Releases
Cachix	`cachix use flk-cache` (prebuilt Nix binaries)

For Nix flake input, overlay, and Home Manager options see the Installation guide.

Shell Hook (optional)

Enable hot-reload (refresh) and profile switching (switch):

eval "$(flk hook bash)"   # or zsh; Fish: flk hook fish | source

📖 Commands

Command	Description
`flk init`	Initialize a new flake environment
`flk add` / `remove`	Add or remove packages (`--version` to pin)
`flk search` / `deep-search`	Search nixpkgs
`flk list` / `show`	List packages or pretty-print full config
`flk cmd add\|remove\|list`	Manage custom shell commands
`flk env add\|remove\|list`	Manage environment variables
`flk profile add\|remove\|list\|set-default`	Manage profiles
`flk activate`	Enter the dev shell
`flk update`	Update flake inputs (auto-backup)
`flk lock show\|history\|restore`	Manage flake.lock snapshots
`flk export`	Export to Docker, Podman, or JSON
`flk direnv init\|attach\|detach`	Direnv integration
`flk hook <shell>`	Generate shell hooks
`flk completions`	Generate shell completions

Most commands accept -p, --profile <NAME> to target a specific profile.

Full command reference → Commands documentation

🛠️ Development

git clone https://github.com/AEduardo-dev/flk.git && cd flk
nix develop                # or ensure Rust 1.83+ is available

cargo build                # debug build
cargo test                 # all tests
cargo fmt --all -- --check && cargo clippy -- -D warnings  # lint

See the Development guide for project structure, testing details, and CI info.

📚 Documentation

Resource	Link
User Guide (mdBook)	aeduardo-dev.github.io/flk
API Reference	docs.rs/flk

Build locally:

# User guide — serve with live reload
cd flk-book && mdbook serve        # http://localhost:3000

# Rust API docs
cargo doc --no-deps --open

# Both via Nix
nix build .#docs

🗺️ Roadmap

Roadmap

🤝 Contributing

Contributions welcome! See [CONTRIBUTING.md]!(CONTRIBUTING.md) for details. For bugs, please open an issue with reproduction steps and environment info.

Devbox — Instant, portable dev environments (inspiration for flk)
devenv — Fast, declarative developer environments
Flox — Developer environments you can take with you
direnv — Shell extension for loading environments

📄 License

MIT — see [LICENSE]!(LICENSE) for details.

🙏 Acknowledgments

The Nix community for creating an amazing ecosystem
Jetify for the Devbox inspiration
Special mention to @vic for nix-versions
All contributors and users of flk

Made with ❤️ by AEduardo-dev