QuickStart (original) (raw)

There are about 75+ options to play with. Some of the most important ones demonstrated here. For all the available options, please read the section Options in the [manual]

At the CLI use man qkw will provide the options to construct a functional set.

To learn more, on how to set up macros and other advanced use cases on how to make the most of qkw, please consult the [manual]

The core option set

• add
• delete
• modify
• search

• Get help

qkw -h

Egs

qkw -h -T -cC qkw -h -D -lA

• Create two tables

qkw -T -cC cmd_1 qkw -T -cD dir_1

• List the tables, and their types
• Add the tables to config file.
• Content retrieval, gets data from the second column or V-column based on labels/tags

only one label taken

qkw -gC # C-tables qkw -gD # D-tables

• Visit a few directories and add labels

current directory information

qkw -addpath p1 # in dir /a/b/c qkw -addpath p2 # in dir x/y

• Add content to the tables manually as label:directory_path strings

directories, D tables

labels can have additional characters for modularity

and easy to remember

qkw -iD m.x:"/u/v/w/x" qkw -iD m.p:"/u/v/w/x/p" qkw -iD n:"/q/r"

commands, C tables

qkw -iC devpush:"git push origin dev" qkw -iC open:"vi /path/to/my/todo/list.txt"

• Check the added content D:directories, C:commands
• Bulk Changes: export/import/removing/modifying data via a file.

template file with fields to populate information

label,value,expl fields

qkw -gettemplate cmdinput.data

write to a file when labels are provided

qkw -C -if cmdoutput.data <L,L...,L> # L:labels

write from file to the database

qkw -C -wf cmdinput.data

add modified data from file, should have existing label

helps when you have changes to make or reuse with variations

qkw -C -mf cmdinput.data

delete the modified data from file, label should exist

rest of the fields are ignored

qkw -C -df cmdinput.data

same operations work for dir tables, but with different format

since the format is "label:directory_path", one per line

NOTE: -gettemplate option doesn't work for dir tables

qkw -D -if dirinput.data qkw -D -mf dirinput.data qkw -D -df dirinput.data qkw -D -wf diroutput.data <L,L...,L> # L:labels

• Check the added data
• Add the macros cd2:navigation, and runfast:command execution in your bashrc or it's equivalent

navigation

cd2(){ cd qkw -gD $1 }

command execution

runfast(){ eval qkw -gC $1 }

source ~/.bashrc and start using the tags

takes you to directory /u/v/w/x

cd2 m

will run your the tagged lss commands

runfast lss

Search for information by tag

"cmd" tables

qkw -sC

"dir" tables

qkw -sD