A cli [TagSpaces][1] client, especially geared towards [The Secret Weapon][2]
approach to Getting Things Done.
# History
A few months into 2017 I read Joan Westenberg's post about how [she uses
Evernote][3] to keep track of all the things that she needs to do. In the
article she has some pretty golden advice:
> Before I get into it though, I want to be clear. What I do might not work
> for you. There is no golden key to productivity, and this is pretty
> specifically designed to match my workflow and my personality.
Which is, of course, fantastic advice.
While I'm sure Evernote is a fantastic tool with all the bells and whistles
that one could desire, it's not exactly *my* bells and whistles. I have a
slightly different approach that I prefer. I'm much more into the command line,
mainly because it's the easiest way to eliminate distractions. Yeah, you can
turn off distractions in your browser and on your phone - but you actually have
to turn *on* distractions on the command line. So I try to spend most of my
time here.
About a year ago I also came across [TagSpaces][1], which has a philosophy I
love: just stick the information into the filename itself. Then it doesn't
matter what system you're using, the information is going to travel with the
file.
After I read Joan's article, I started trying to use the TagSpaces client. It
worked well enough, though it wasn't quite as keyboard-centric as I wanted.
Using Dropbox to sync my files worked great (though they still don't have a
client for the Raspberry Pi, grumble grumble).
I toyed around with using the command line, `ls *1-now*` or `find . -name
*3-soon*` worked pretty well, but it was still a bit clunky. Out of that need
came Shibboleth
# Guide
Shibboleth is pretty simple. At the moment it only supports Linux-y systems
(there's some weirdness on Mac OSX, with readline), but I'm always open to
[pull requests][4]!
All you have to do is install shibboleth:
python3 -m pip install shibboleth
Or even better, use [pipx][pipx]:
pipx install shibboleth
(Come join me in the glorious future that is Python3 ~~.6~~! Or, if you think it's
awesome and you live in some horrible reality that requires something ancient,
did I mention that I'm totally accepting [pull requests][4]?)
Once it's installed, just start it up in whatever directory you want to stick
your stuff. Maybe you do something like this:
$ mkdir secret-weapon
$ cd secret-weapon
$ mkdir completed
$ shibboleth
Welcome to Shibboleth, the tool designed to be *your* secret weapon.
Your editor is currently vim. If you don't like that, you
should change or set your EDITOR environment variable.
⇀shibboleth:/home/wayne/secret-weapon
>new
Title: Try out shibboleth
That will launch your editor - whatever your `EDITOR` environment variable is
set to. Or `vim`, if nothing is set. `:q` is how you get out of Vim, if
that's not your thing. I added the text
> Trying out shibboleth, how does it work for me?
Save and quit and you should come back to shibboleth:
⇀shibboleth:/tmp/fnord/Try-out-shibboleth[20170406~011315 inbox].md
>show
********************************************************************************
Title: Try out shibboleth
Trying out shibboleth, how does it work for me?
********************************************************************************
⇀shibboleth:/tmp/fnord/Try-out-shibboleth[20170406~011315 inbox].md
>
It will automatically select the new file. You may notice that it changed the
spaces for `-`. That's because readline is confusing and hard and doesn't
like autocompleteing spaces. But if you can make it do the right thing, did I
mention I'm accepting [pull requests][4]?
Recently (in January 2022) I was reminded of the "inbox" functionality, so I
added that as the default "priority" that will show up in the report.
Of course, you can change the priority of your selected file/task with
`priority`, or the shortcut `p`.
>p 6
⇀shibboleth:/tmp/fnord/Try-out-shibboleth[20170406~011315 6-waiting].md
>
You can `deselect` to drop that, or `select` a different file. Or create
another `new` one:
>new something completely different
⇀shibboleth:/tmp/fnord/something-completely-different[20170406~013345 inbox].md
>show
********************************************************************************
A man with three legs!
> 'e ran off!
********************************************************************************
⇀shibboleth:/tmp/fnord/something-completely-different[20170406~013345 inbox].md
p 4
⇀shibboleth:/tmp/fnord/something-completely-different[20170406~013345 4-later].md
>
You can use `ls` to list all the files in the directory, `cd` to change
directory. Or if you just want to see what you're supposed to be doing now:
>now
trying-out-shibboleth[20170406~013326 1-now].md
⇀shibboleth:/tmp/fnord/trying-out-shibboleth[20170406~013326 1-now].md
>later
something-completely-different[20170406~013345 4-later].md
⇀shibboleth:/tmp/fnord/trying-out-shibboleth[20170406~013326 1-now].md
>
Or if you want a high-level view, use `report`:
>report
inbox
1-now (1/2)
Trying-out-shibboleth[20220102~210020 1-now].md
2-next (0/2)
3-soon (0/2)
4-later (1/2)
something-completely-different[20220102~210043 4-later].md
5-someday (0/2)
6-waiting (0/2)
done (0/2)
None (0/2)
You can use the `work` command to process either a priority or any other label.
Once you're done with a thing, you can `compelete` it, or be `done` with
it:
>done
⇀shibboleth:/tmp/fnord
>cd completed
⇀shibboleth:/tmp/fnord/completed
>ls
something-completely-different[20170406~013345 done].md
That's really about all there is to it. The way I use Shibboleth for my
day-to-day:
- Start up shibboleth.
- `select startup` which contains a bunch of URLs that I need to open.
- `launch` to open up all my startup URLs.
- `work 6` to work my waiting list, to see if there's anything I need to move
out of waiting.
- Go through `someday`, `later`, `soon`, and `next` to see if anything needs to
be bumped up.
- Decide which of `now` I need to work on the most, then `s` elect it. I may
`ed` it to add some notes or just `show` to review what I'm supposed to be
doing, and probably `launch` the relevant URLs. Then when I finish that I
mark it `done` and move on to the next.
As new tasks come in via email, etc. I go ahead and add new ones. I've been
using shibboleth as the interface for my tasks for a while now and it works
*great* for shifting the priority, creating new tasks, and editing ones that
I've got.
If you've got any suggestions about what would make shibboleth (more) awesome,
I'm happy to work with you to get your [pull request][4] in. Or if I've got
some time or I think it's a killer feature, I'm sure I'll add it to my own
list. Using shibboleth, of course :)
<a id="philosophy"></a>
Philosophy
----------
I would prefer to keep this as 3rd-party-dependency-free as possible. ~~I'm not
opposed to adding some kind of plugin architecture, but~~ (Plugins were added!)
I *really* want shibboleth to stay one single file. That way you can just stick
it in a directory and you're good to go.
<a id="plugins"></a>
Plugins
-------
I've added a plugin architecture! Currently it requires plugins to be found in
`~/.shibboleth/plugins`. Plugins will be attached to Shibboleth's main loop as
if they were methods, using the filename as the name of the command. For
instance, if you wanted to add a really bad pomodoro timer, you could do that
by creating a `pom.py` in the plugin directory that contained the following:
import time
def handle(self, line):
print('Pomodoro', line)
time.sleep(60*20) # sleep for 20 minutes
print('Pomodoro done!')
If you wanted to make it drop straight into the editor you could add:
self.edit('')
At the end of the function.
<a id="auto_git_tracking"></a>
Automatic Git Tracking
----------------------
When commands finish, any untracked/committed changes will be automatically
added and committed. This means that when doing `did` or `done`, or tagging
files will automatically be tracked.
Currently git is the only VCS backend that's supported, but it should be pretty
reasonable to extend the behavior to other backends, like mercurial or fossil.
TODOs
-----
- ~~Add BSD license~~ - Done 2018-10-01
- ~~Add other tag support~~ - Done 2018-10-01
- config. We want to be able to config shibboleth, right? Different colors and
what-not.
<a id="changelog"></a>
CHANGELOG
---------
## [0.9.1] - [2023-10-13]
### Changed
- `done` and `completed` no longer move `done` tasks to a different dir.
### Fixed
- `pls inbox` now works.
- `report <priority>` now will only list the tasks for that priority.
- `work` no longer crashes when given a bad set of tags. Also more helpful
output.
## [0.9.0] - [2022-10-29]
### Added
- Added launch and view/show functionality to review.
- Added tag autocomplete to tag/untag functions.
### Fixed
- If review changes a selected task, it'll be deselected.
## [0.8.0] - [2022-01-03]
### Added
- "inbox" as a priority.
### Changed
- "inbox" as the default priority.
### Fixed
- Restored `1-now` as the default work priority.
## [0.7.1] - [2022-01-02]
### Fixed
- Fixed bug when your shibboleth directory was a subfolder in a repo that had
modified files in a different directory in the repo.
## [0.7.0] - [2022-01-02]
### Added
- [Automatic git tracking](#auto_git_tracking).
- `clear` priority to... well, clear the priority!
- Title is now inserted automatically into the file.
### Changed
- `did` now inserts timestamps with a header instead of relying on the
blank-space-at-the-end-of-a-line for CommonMark rendering.
- `work` now supports arbitrary tag matching, with autocomplete. Allows for
working priority labels or other labels.
### Fixed
- Mis-provided `log` command no longer crashes, improved logging.
- No longer pass vim flags to all editors.
---
## [0.6.0] - [2021-06-17]
## Fixed
- Unhandled exceptions are now caught and written to shibboleth.log instead of
crashing.
- Added `launch` command, which will launch URLs found in headers in the task
file.
## [0.5.0] - [2019-10-15]
### Added
- `work` subcommand, to allow you to quickly process a particular priority. By
default, it will work `1-now`, but `work 2` will work the "next" tasks.
- `version` command, to display the current version of shibboleth.
### Changed
- Updated how prompt is generated. Shouldn't cause an issue, but something to
be aware of, especially in plugins.
- Default priority is now `now` - this helps with tasks falling through the
cracks.
## [0.4.1] - [2019-10-14]
### Changed
- `cmdloop` passes on `*args` and `**kwargs` - useful for running loops from
plugins.
## [0.4.0] - [2019-07-31]
### Added
- Review command that lets you cycle through your tasks, updating priorities.
### Changed
- Duplicate tags are no longer allowed, though if added outside Shibboleth they
will not be interfered with.
## [0.3.0]
### Added
- Plugin system. Add `.py` files to `~/.shibboleth/plugins` to extend the
functionality of Shibboleth.
- Keep a changelog functionality for the changelog.
[1]: https://www.tagspaces.org/ "TagSpaces"
[2]: http://www.thesecretweapon.org/the-secret-weapon-manifesto/manifesto-part-1-the-issue "The Secret Weapon Manifesto"
[3]: https://web.archive.org/web/20190225071845/https://medium.com/hi-my-name-is/how-i-use-evernote-to-pitch-at-the-top-of-my-game-2c5966ef720b
[4]: https://github.com/waynew/shibboleth#fork-destination-box
[pipx]: https://pypa.github.io/pipx/
Raw data
{
"_id": null,
"home_page": "",
"name": "shibboleth",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "cli,task,tracking,commandline,productivity",
"author": "",
"author_email": "",
"download_url": "",
"platform": null,
"description": "A cli [TagSpaces][1] client, especially geared towards [The Secret Weapon][2]\napproach to Getting Things Done.\n\n# History\n\nA few months into 2017 I read Joan Westenberg's post about how [she uses\nEvernote][3] to keep track of all the things that she needs to do. In the\narticle she has some pretty golden advice:\n\n> Before I get into it though, I want to be clear. What I do might not work\n> for you. There is no golden key to productivity, and this is pretty\n> specifically designed to match my workflow and my personality.\n\nWhich is, of course, fantastic advice.\n\nWhile I'm sure Evernote is a fantastic tool with all the bells and whistles\nthat one could desire, it's not exactly *my* bells and whistles. I have a\nslightly different approach that I prefer. I'm much more into the command line,\nmainly because it's the easiest way to eliminate distractions. Yeah, you can\nturn off distractions in your browser and on your phone - but you actually have\nto turn *on* distractions on the command line. So I try to spend most of my\ntime here.\n\nAbout a year ago I also came across [TagSpaces][1], which has a philosophy I\nlove: just stick the information into the filename itself. Then it doesn't\nmatter what system you're using, the information is going to travel with the\nfile.\n\nAfter I read Joan's article, I started trying to use the TagSpaces client. It\nworked well enough, though it wasn't quite as keyboard-centric as I wanted.\nUsing Dropbox to sync my files worked great (though they still don't have a\nclient for the Raspberry Pi, grumble grumble).\n\nI toyed around with using the command line, `ls *1-now*` or `find . -name\n*3-soon*` worked pretty well, but it was still a bit clunky. Out of that need\ncame Shibboleth\n\n# Guide\n\nShibboleth is pretty simple. At the moment it only supports Linux-y systems\n(there's some weirdness on Mac OSX, with readline), but I'm always open to\n[pull requests][4]!\n\nAll you have to do is install shibboleth:\n\n python3 -m pip install shibboleth\n\nOr even better, use [pipx][pipx]:\n\n pipx install shibboleth\n\n\n(Come join me in the glorious future that is Python3 ~~.6~~! Or, if you think it's\nawesome and you live in some horrible reality that requires something ancient,\ndid I mention that I'm totally accepting [pull requests][4]?)\n\nOnce it's installed, just start it up in whatever directory you want to stick\nyour stuff. Maybe you do something like this:\n\n\n $ mkdir secret-weapon\n $ cd secret-weapon\n $ mkdir completed\n $ shibboleth\n Welcome to Shibboleth, the tool designed to be *your* secret weapon.\n\n Your editor is currently vim. If you don't like that, you\n should change or set your EDITOR environment variable.\n\n \u21c0shibboleth:/home/wayne/secret-weapon\n >new\n Title: Try out shibboleth\n\nThat will launch your editor - whatever your `EDITOR` environment variable is\nset to. Or `vim`, if nothing is set. `:q` is how you get out of Vim, if\nthat's not your thing. I added the text \n\n> Trying out shibboleth, how does it work for me?\n\nSave and quit and you should come back to shibboleth:\n\n \u21c0shibboleth:/tmp/fnord/Try-out-shibboleth[20170406~011315 inbox].md\n >show\n ********************************************************************************\n Title: Try out shibboleth\n\n Trying out shibboleth, how does it work for me?\n\n ********************************************************************************\n \u21c0shibboleth:/tmp/fnord/Try-out-shibboleth[20170406~011315 inbox].md\n >\n\nIt will automatically select the new file. You may notice that it changed the\nspaces for `-`. That's because readline is confusing and hard and doesn't\nlike autocompleteing spaces. But if you can make it do the right thing, did I\nmention I'm accepting [pull requests][4]?\n\nRecently (in January 2022) I was reminded of the \"inbox\" functionality, so I\nadded that as the default \"priority\" that will show up in the report.\n\nOf course, you can change the priority of your selected file/task with\n`priority`, or the shortcut `p`.\n\n >p 6\n \u21c0shibboleth:/tmp/fnord/Try-out-shibboleth[20170406~011315 6-waiting].md\n >\n\nYou can `deselect` to drop that, or `select` a different file. Or create\nanother `new` one:\n\n >new something completely different\n \u21c0shibboleth:/tmp/fnord/something-completely-different[20170406~013345 inbox].md\n >show\n ********************************************************************************\n A man with three legs!\n\n > 'e ran off!\n\n ********************************************************************************\n \u21c0shibboleth:/tmp/fnord/something-completely-different[20170406~013345 inbox].md\n p 4\n \u21c0shibboleth:/tmp/fnord/something-completely-different[20170406~013345 4-later].md\n >\n\nYou can use `ls` to list all the files in the directory, `cd` to change\ndirectory. Or if you just want to see what you're supposed to be doing now:\n\n >now\n trying-out-shibboleth[20170406~013326 1-now].md\n \u21c0shibboleth:/tmp/fnord/trying-out-shibboleth[20170406~013326 1-now].md\n >later\n something-completely-different[20170406~013345 4-later].md\n \u21c0shibboleth:/tmp/fnord/trying-out-shibboleth[20170406~013326 1-now].md\n >\n\nOr if you want a high-level view, use `report`:\n\n >report\n inbox\n 1-now (1/2)\n Trying-out-shibboleth[20220102~210020 1-now].md\n 2-next (0/2)\n 3-soon (0/2)\n 4-later (1/2)\n something-completely-different[20220102~210043 4-later].md\n 5-someday (0/2)\n 6-waiting (0/2)\n done (0/2)\n None (0/2)\n\nYou can use the `work` command to process either a priority or any other label. \n\nOnce you're done with a thing, you can `compelete` it, or be `done` with\nit:\n\n >done\n \u21c0shibboleth:/tmp/fnord\n >cd completed\n \u21c0shibboleth:/tmp/fnord/completed\n >ls\n something-completely-different[20170406~013345 done].md\n\n\nThat's really about all there is to it. The way I use Shibboleth for my\nday-to-day:\n\n- Start up shibboleth.\n- `select startup` which contains a bunch of URLs that I need to open.\n- `launch` to open up all my startup URLs.\n- `work 6` to work my waiting list, to see if there's anything I need to move\n out of waiting.\n- Go through `someday`, `later`, `soon`, and `next` to see if anything needs to\n be bumped up.\n- Decide which of `now` I need to work on the most, then `s` elect it. I may\n `ed` it to add some notes or just `show` to review what I'm supposed to be\n doing, and probably `launch` the relevant URLs. Then when I finish that I\n mark it `done` and move on to the next.\n\nAs new tasks come in via email, etc. I go ahead and add new ones. I've been\nusing shibboleth as the interface for my tasks for a while now and it works\n*great* for shifting the priority, creating new tasks, and editing ones that\nI've got.\n\nIf you've got any suggestions about what would make shibboleth (more) awesome,\nI'm happy to work with you to get your [pull request][4] in. Or if I've got\nsome time or I think it's a killer feature, I'm sure I'll add it to my own\nlist. Using shibboleth, of course :)\n\n\n<a id=\"philosophy\"></a>\n\nPhilosophy\n----------\n\nI would prefer to keep this as 3rd-party-dependency-free as possible. ~~I'm not\nopposed to adding some kind of plugin architecture, but~~ (Plugins were added!)\nI *really* want shibboleth to stay one single file. That way you can just stick\nit in a directory and you're good to go.\n\n\n<a id=\"plugins\"></a>\n\nPlugins\n-------\n\nI've added a plugin architecture! Currently it requires plugins to be found in\n`~/.shibboleth/plugins`. Plugins will be attached to Shibboleth's main loop as\nif they were methods, using the filename as the name of the command. For\ninstance, if you wanted to add a really bad pomodoro timer, you could do that\nby creating a `pom.py` in the plugin directory that contained the following:\n\n import time\n\n\n def handle(self, line):\n print('Pomodoro', line)\n time.sleep(60*20) # sleep for 20 minutes\n print('Pomodoro done!')\n\nIf you wanted to make it drop straight into the editor you could add:\n\n self.edit('')\n\nAt the end of the function.\n\n\n<a id=\"auto_git_tracking\"></a>\n\nAutomatic Git Tracking\n----------------------\n\nWhen commands finish, any untracked/committed changes will be automatically\nadded and committed. This means that when doing `did` or `done`, or tagging\nfiles will automatically be tracked.\n\nCurrently git is the only VCS backend that's supported, but it should be pretty\nreasonable to extend the behavior to other backends, like mercurial or fossil.\n\n\nTODOs\n-----\n\n- ~~Add BSD license~~ - Done 2018-10-01\n- ~~Add other tag support~~ - Done 2018-10-01\n- config. We want to be able to config shibboleth, right? Different colors and\n what-not.\n\n<a id=\"changelog\"></a>\n\nCHANGELOG\n---------\n\n## [0.9.1] - [2023-10-13]\n\n### Changed\n\n- `done` and `completed` no longer move `done` tasks to a different dir.\n\n### Fixed\n\n- `pls inbox` now works.\n- `report <priority>` now will only list the tasks for that priority.\n- `work` no longer crashes when given a bad set of tags. Also more helpful\n output.\n\n## [0.9.0] - [2022-10-29]\n\n### Added\n\n- Added launch and view/show functionality to review.\n- Added tag autocomplete to tag/untag functions.\n\n### Fixed\n\n- If review changes a selected task, it'll be deselected.\n\n## [0.8.0] - [2022-01-03]\n\n\n### Added\n\n- \"inbox\" as a priority.\n\n### Changed\n\n- \"inbox\" as the default priority.\n\n### Fixed\n\n- Restored `1-now` as the default work priority.\n\n## [0.7.1] - [2022-01-02]\n\n### Fixed\n\n- Fixed bug when your shibboleth directory was a subfolder in a repo that had\n modified files in a different directory in the repo.\n\n## [0.7.0] - [2022-01-02]\n\n### Added\n\n- [Automatic git tracking](#auto_git_tracking).\n- `clear` priority to... well, clear the priority!\n- Title is now inserted automatically into the file.\n\n### Changed\n\n- `did` now inserts timestamps with a header instead of relying on the\n blank-space-at-the-end-of-a-line for CommonMark rendering.\n- `work` now supports arbitrary tag matching, with autocomplete. Allows for\n working priority labels or other labels.\n\n### Fixed\n\n- Mis-provided `log` command no longer crashes, improved logging.\n- No longer pass vim flags to all editors.\n\n---\n\n## [0.6.0] - [2021-06-17]\n\n## Fixed\n\n- Unhandled exceptions are now caught and written to shibboleth.log instead of\n crashing.\n- Added `launch` command, which will launch URLs found in headers in the task\n file.\n\n## [0.5.0] - [2019-10-15]\n\n### Added\n\n- `work` subcommand, to allow you to quickly process a particular priority. By\n default, it will work `1-now`, but `work 2` will work the \"next\" tasks.\n- `version` command, to display the current version of shibboleth.\n\n### Changed\n\n- Updated how prompt is generated. Shouldn't cause an issue, but something to\n be aware of, especially in plugins.\n- Default priority is now `now` - this helps with tasks falling through the\n cracks.\n\n## [0.4.1] - [2019-10-14]\n\n### Changed\n\n- `cmdloop` passes on `*args` and `**kwargs` - useful for running loops from\n plugins.\n\n## [0.4.0] - [2019-07-31]\n\n### Added\n\n- Review command that lets you cycle through your tasks, updating priorities.\n\n### Changed\n\n- Duplicate tags are no longer allowed, though if added outside Shibboleth they\n will not be interfered with.\n\n## [0.3.0]\n\n### Added\n\n- Plugin system. Add `.py` files to `~/.shibboleth/plugins` to extend the\n functionality of Shibboleth.\n- Keep a changelog functionality for the changelog.\n\n\n[1]: https://www.tagspaces.org/ \"TagSpaces\"\n[2]: http://www.thesecretweapon.org/the-secret-weapon-manifesto/manifesto-part-1-the-issue \"The Secret Weapon Manifesto\"\n[3]: https://web.archive.org/web/20190225071845/https://medium.com/hi-my-name-is/how-i-use-evernote-to-pitch-at-the-top-of-my-game-2c5966ef720b\n[4]: https://github.com/waynew/shibboleth#fork-destination-box\n[pipx]: https://pypa.github.io/pipx/\n",
"bugtrack_url": null,
"license": "BSD 3-Clause License",
"summary": "Command line tool for tracking tasks",
"version": "0.9.1",
"project_urls": null,
"split_keywords": [
"cli",
"task",
"tracking",
"commandline",
"productivity"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "00c89c352af063426910be5cb50225453e6449c5a1ec5e97996e3368a0e8abe8",
"md5": "b71e1be2f78a6a0ebc11785f9ea999a8",
"sha256": "568398837e901a24bf329061190995aa6e1f700331b2f7e0bf20a247fff2043f"
},
"downloads": -1,
"filename": "shibboleth-0.9.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b71e1be2f78a6a0ebc11785f9ea999a8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 15215,
"upload_time": "2023-10-13T04:00:25",
"upload_time_iso_8601": "2023-10-13T04:00:25.343573Z",
"url": "https://files.pythonhosted.org/packages/00/c8/9c352af063426910be5cb50225453e6449c5a1ec5e97996e3368a0e8abe8/shibboleth-0.9.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-13 04:00:25",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "shibboleth"
}
JSON