Skip to content
/ gitn Public

a super simple cross-platform command line note taking application that makes life much more easier

License

Notifications You must be signed in to change notification settings

pg07codes/gitn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gitnLogo

a super simple cross-platform command line note taking application that makes life much more easier

What exactly is gitn ?

  • If you work on CLI a lot and don't want to waste your time managing your notes from anywhere but the command line
  • gitn follows the same commands as git and so there is nothing new to know or learn. Just install and use.

Installation and Usage

>>> npm install -g gitn 

>>> gitn config -g '/absolute/path/to/your/notes/directory/where-gitn-will-save-notes'

>>> gitn --help  // to know all the commands that gitn offers 

What you mean exactly by similar to git ?

  • Firstly dont confuse gitn for some Version Control System . It follows same commands as git and is a powerful notes manager for folks who ❤️ CLI but apart from it , it is not related to vcs.
  • This illustration will make it much more clear on how commands for gitn are similar to git and what it means when you create a branch/commit in gitn

GIT GITN equivalence

Now, have a look at the gitn commands ( same as git isn't it ?)

cmdline

Simple Internals

  • gitn maintains a root directory (which you specify using gitn config -g <absolute-path-to-root-directory>) for your notes and maintains text files for your branches in this root directory.
  • This makes it easy to access the notes through any text editor in case you need to.
  • In case you don't feel like using gitn anymore, just uninstall it. Your notes are always there.
  • Have a look at it in this pic (root directory with .txt files ) notes-folder

Commands

As of now, gitn supports the following commands

  • gitn config - to update configuration parameters
  • gitn status - to see which branch user is currently on
  • gitn commit - to add a new commit (aka note) to the branch user is currently on
  • gitn log - to view all commits (allows for searching using grep)
  • gitn branch - to view/create/delete branches(aka text-files)
  • gitn checkout - to switch to a different branch ( use -b flag to create and switch)
  • gitn rebase - select specific commits to be deleted from current branch
  • gitn reset - to delete all commits from current branch
  • gitn merge - to merge two branches (and their commits) onto a single branch

TODOS

  • git like command line API (version 0.1.0)
  • allow for notes searching using words or RegEx
  • allow for users to encrypt notes
  • add date to each note to allow for date based searching
  • allow for adding notes to any directory using git init and git add commands
  • and many many more . Make an issue if you think a feature is cool enough to be added to gitn

Developed and Maintained By

  • Pranav Gupta
  • If you like it, consider ⭐ ing this repo 😄

About

a super simple cross-platform command line note taking application that makes life much more easier

Topics

Resources

License

Stars

Watchers

Forks