Updates to HeapCL / List Events, Filtering Lists & Save in GTD Format

To support the new features in the WebHook, HeapCL (Heap CRM's command line interface) has been updated.

Listing Events

First, let’s say I want to list events, I can type:

./heapCL --list="events"

And that would return all uncompleted events that I own or are associated to a prospect where I'm a managing user to my screen. I also could type:

./heapCL --list="events" --save="events.csv"

Which would save those events to a CSV file (in this case named events.csv).

Filtering Lists

Just like the WebHook itself, HeapCL now supports filtering lists. Let’s say I want any event associated to John Doe, I could type:

./heapCL --list="events John Doe"

If I wanted to filter e-mail templates I could type something like:

./heapCL --list="emailtemplates Hello World!" --save="templates.csv"

Which would return email templates where the subject line starts with "Hello World!" and save them to the file "templates.csv".

Saving in GTD Format

When listing events, you now have the option to save in a GTD (Getting Things Done) style format. If I type something like (ie. the key difference being the ".txt" instead of ".csv"):

./heapCL --list="events" --save="events.txt"

HeapCL will save a file similar to the following:

+John_Doe_-_ACME Holiday Follow-up on Feb 1st, 2011
+John_Doe_-_ACME @Tasks My Breakfast Meeting at 08:30 AM to 09:30 AM on Feb 6th, 2011
@Tasks Talk about Client Test on Mar 4th, 2011
...

Where each event is on its own new line, associations specified with a "+" and calendars specified with a "@". This format is commonly used when applying David Allen's Getting Things Done methodology and is compatible with programs like Todo.txt.

Save E-Mail Templates in Plain Text

When listing email templates, you now have the option to save them in plain text instead of CSV. If I type something like (ie. the key difference being the ".txt" instead of ".csv"):

./heapCL --list="emailtemplates" --save="templates.txt"

HeapCL will save all email templates in plain text format.

Updates to LaunchBar and QuickSilver Scripts

Both the LaunchBar and QuickSilver action scripts have been updated to take full advantage of the additional features. So once you update your action scripts, you can filter lists, grab events and save events in GTD format.

LaunchBar Action Script >
QuickSilver Action Script >

Installation and Update

Because of substantial changes to HeapCL, it is recommend for all users to download a new copy. Those of you updating will not have to reconfigure any settings, you will simply have to overwrite your existing installation with the new one.

Download >
More about HeapCL >

One Response to “Updates to HeapCL / List Events, Filtering Lists & Save in GTD Format”

  1. WBP SYSTEMS / Weblog » Blog Archive » Import Events into Heap CRM via CSV Says:

    [...] The import format matches the event CSV export added to HeapCL in March. [...]

Leave a Reply