node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org ยป



A CLI for FoldingText, TaskPaper, and Markdown text.


This is a command line interface (cli) for FoldingText, TaskPaper, and Markdown formatted text files. It has two subcommands:

  1. get filters the text using a FoldingText node path.

  2. evaluate runs a JavaScript function over a FoldingText node tree.

Each command takes two options, taxonomy and modes.

The --taxonomy option determines how the text is parsed to create the node tree. The default taxonomy is foldingtext, but you can also parse the text as taskpaper or markdown format.

If you are using the foldingtext taxonomy, then you can also use the --modes option to signal what modes should be parsed.

Questions and comments should be directed to the dev catagory in the FoldingText support forums.


Return all "not @done" lines:

$ ft get "//not @done" myfile.ft

Return "toString" on node tree:

$ ft evaluate -p "my param" "function (tree, param) { return tree.toString() + param; }" myfile.ft

Release Notes


  • Fixed parsing bug


  • Added new --param option to the evaluate command. The value of that param is passed into the JavaScript function as second parameter.


  • fixed reported version when passed in -v flag.


  • script paramater can now be filename or inline script.