Skip to content

Commit

Permalink
outline app structure in readme
Browse files Browse the repository at this point in the history
  • Loading branch information
peter-bread committed Jan 30, 2024
1 parent bb8fd2c commit 7f7e355
Show file tree
Hide file tree
Showing 2 changed files with 87 additions and 0 deletions.
Empty file added LICENSE
Empty file.
87 changes: 87 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,89 @@
# gamon

GitHub Account Manager

## Prerequisites

### OS

MacOS / Linux

### Shell

zsh / bash (maybe add fish support in future)

## Dependencies

### Applications

- gh
- jq

### Go Packages

- cobra
- promptui ???

## Command Structure

```text
gam <command>
|-- init [<filepath>]
|-- account <command>
| |-- add <account name>
| |-- remove <account name>
| |-- edit
| |-- list
| |-- view <account name>
|-- config
```

### `gam <command>`

Root command. Must be followed by a subcommand.

### `gam init [<filepath>]`

Initialises file structure. Optional argument filepath.

Without an argument, creates repo structure in (home or current ??? directory).

With an argument, creates repo structure at that path (is the path where `repos/` is created or is it where `work/` and `personal/` are created ??? leaning towars `repos/` I think ???).

### `gam account <command>`

Manages account names. Must be followed by a sucommand.

### `gam account add <account name>`

Takes in a single argument: account name.

Adds account name to account names file (if it is not already there).

### `gam account remove <account name>`

Takes in a single argument: account name.

Removes account name from account names file (if it is already there).

### `gam account edit`

Opens account names file using `$EDITOR` if set, else `nano`, so user can manually add/remove accounts.

### `gam account list`

Print all currently added account names to the terminal.

### `gam account view <account name>`

Takes in a single argument: account name.

Lists all the repos in that account's directory.

Could print any other settings associated with that account.

### `gam config`

Opens config file using `$EDITOR` if set, else `nano`.

Allows user to adjust other settings (yet to be defined).

0 comments on commit 7f7e355

Please sign in to comment.