marvin-cli
A command-line tool for interfacing with the Amazing Marvin desktop app and public API.
This is a work-in-progress. Not all documented features are working and/or working as expected. PRs welcome!
While you can use Marvin's public API to create tasks, scripting is a bit easier with a command-line tool so that you can:
marvin add task "Example +today"
But even more importantly, until now scripting wasn't possible for desktop users who disable cloud sync. As of 1.60.0 you can run a local API server which serves a subset of the public API, plus some bonus commands that only work on desktop.
So marvin-cli can either communicate with the public API or a desktop app instance.
COMMANDS:
api - View API docs
config - Get/set config values for marvin-cli
add - Add a Task, Project, or other
due - Get open Tasks & Projects due today (or earlier)
get - Read an arbitrary document from your database
today - List Tasks and Projects that are scheduled today
tracking - Get the currently tracked task
update - Update a Task, Project, or other (not yet implemented)
delete - Delete a Task, Project, or other (not yet implemented)
help - Help about any command
DESKTOP COMMANDS:
run - Start the desktop app (not yet implemented)
quickAdd - Open desktop quick add
list - List Tasks/Projects, optionally filtered
backup - Trigger backups (not yet implemented)
restore - Restore backups (not yet implemented)
quit - Shut down the app (not yet implemented)
Download a release for your platform here.
./build
(or BUILD.bat
on windows)marvin-cli
(or marvin-cli.exe
on windows) to your pathGet your API Token from https://app.amazingmarvin.com/pre?api (or find it in the API strategy settings) then run marvin config apiToken XYZ
or use the --api-token
command line option.