Gusabary / Arenta

A terminal-based daily task management tool with minimal overhead

Arenta

A terminal-based daily task management tool with minimal overhead.

Demo

Features

• Complete CRUD support of daily tasks with intuitive syntax
• Visualized task schedule with colorful timeline
• A single executable binary and naturally terminal based
• Retentiveness by storing tasks in local file

Install

Several alternatives:

• Recommended: cargo install arenta
• cargo install --git https://github.com/Gusabary/Arenta.git
• Download binary from Release page and put it into $PATH
• Clone the repo and build from source

Usage

Use arenta -h to show help messages and arenta -v to check the version.

Use arenta to start an interactive session, in which you could manage daily tasks easily.

Task Definition

Task is the core concept in Arenta, which consists of description, planned start/complete time, actual start/complete time and status.

The description and time part could be set and edited with Arenta commands, while the status is managed by Arenta in such rules:

	planned start	planned complete	actual start	actual complete
Backlog	unset	unset	unset	unset
Planned	set and later than now	set	unset	unset
Overdue	set and earlier than now	set	unset	unset
Ongoing	set / unset	set / unset	set	unset
Complete	set / unset	set / unset	set	set

Command Syntax

The interactive session accepts valid Arenta commands:

• Type in n or new to create a new task in an interactive way:

  arenta> n
   description: a new task
   how to arrange this task
  > start immediately
    put in backlog
    plan to...
  

• Type in s or start plus a task index to start it:

  arenta> s 0
  task 0 started
  

• Type in c or complete plus a task index to complete it:

  arenta> c 0
  task 0 completed
  

• Type in ls or ll with [date_filter] and [flags] to list all tasks in specified date range.

  • ll will render a visualized timeline as well, in which the planned period is represented as - while actual period is =
  • [date_filter] is in format of <op><date>
    • <op> could be <, <=, >, >= or empty, which indicates ==. Note that for ll, <op> must be empty.
    • <date> could take format of mm-dd, yyyy-mm-dd or just an integer, which indicates offset to today.
  • [flags] could contain b or v
    • b flag to display backlog tasks as well
    • v flag to display in verbose mode

  # list today's tasks
  > ls
  
  # list tomorrow's tasks with timeline
  > ll +1
  
  # list all historical tasks in verbose mode
  > ls <0 v
  
  # list yesterday's tasks including backlog and timeline in verbose mode
  > ll -1 bv
  

• Type in h or help to show the complete usage of all Arenta commands

Todos

• [usability] make the Arenta interactive session more shell-like, e.g. can use up arrow key to pop up last command
• [scalability] take a more scalable approach to save all tasks to local file
• [customizability] expose some settings as configurable, e.g. length of timeline, color of status, task display pattern, etc.

License

MIT