#projects #find #directory #tui #line #file #finding

app porgi

A simple cli TUI for finding and organizing code projects

3 releases (breaking)

0.3.0 Sep 3, 2024
0.2.0 Aug 26, 2024
0.1.0 Aug 20, 2024

#2368 in Command line utilities

Download history 147/week @ 2024-08-19 168/week @ 2024-08-26 143/week @ 2024-09-02 57/week @ 2024-09-16

374 downloads per month

MIT license

220KB
693 lines

Porgi 🐾

A corgi to organize and find your projects, a porgi.

Probably don't use this yet since its very much a WIP.

obligatory screen shot of porgi in action as it snappily loads projects and lets the user view readme files.

If you are like me you probably have some directory on computer brimming with hopes, dreams, and build files called "projects". If you often find yourself scratching your head and forgetting where put that very important weird cli tool that you now can't live with out (perhaps because you name everything corgi) this tool is for you.

Installation

You will need to have rust and cargo installed. https://rustup.rs/ will install this.

Once you have cargo installed you can install:

cargo install porgi

Configuring your porgi

Porgi require a config file to run for now

Add the following to ~/.config/porgi/porgi.toml

# Add your project directories here
project_dirs = ["~/projects"]

# Set the editor or IDE you (o) will use to open the project
#
# Options:
# - "auto" (default): Use the first working opener
# - "code": Use Visual Studio Code
# - "editor": Use the EDITOR environment variable
# - "config": Use custom command (WIP)
opener = "auto"

Features

  • Multiple project directories
  • Sort projects by most recent changes
  • Open in editor
  • New user onboarding (TBD if this will be in TUI)
  • Preview of file tree
  • Stats for project such as file count, lines of code etc...
  • Cleaning old build files and projects
  • Checking projects are up to date in git

Other project finding tools

projects-cli

Dependencies

~29–43MB
~738K SLoC