See T3569, D7349.

I think this is mostly good, but I want the CLI to be stack-aware. We probably need three commands:

• arc tracking (or arc work or arc track or arc list-time or something): shows the stack
• arc start (or whatever): pushes onto the stack
• arc stop (or whatever): pops the stack

So usage would go like this:

$ arc tracking
(In Progress)   2h  T122: Fetch Lumber
(Suspended)    30m  T121: Build Cabin

This shows that you're currently fetching lumber. If something comes up, you might run:

$ arc start T123
Started: T123: Put out a fire

(In Progress)   1s  T123: Put out the fire
(Suspended)     2h  T122: Fetch Lumber
(Suspended)    30m  T121: Build Cabin

Once the fire is out, you'd run:

$ arc stop
Stopped: T123: Put out a fire 
Time Spent: 25m

(In Progress)   2h  T122: Fetch Lumber
(Suspended)    30m  T121: Build Cabin

That is, by default arc stop would just pop the stack. The full signature for arc stop should probably be:

$ arc stop [object | --all] [--note 'note'] [--at time]

Where --note lets you provide a note, and --at lets you provide an alternate (presumably, earlier) end time. --all would stop everything on your stack (e.g., if you're heading home for the day).

Do those seem reasonable? If we want to head in that direction, we should add query method, and stop shouldn't require a PHID (if one isn't provided, it should just pop the top of the stack). It should also probably return the object that was popped, and the time spent on it.

I don't think arc start T123 is a good syntax. If tomorrow i wish to add support for tracking time spent on wiki pages, or a pholio mock, then this might become confusing.

Instead, I feel arc start --task T123 is better, because it's explicit, and if a user really wishes to reduce keystrokes, they can just alias currently-being-forced-to-work-on="arc start --task" which is well supported in all shells (don't know about windows)

Shouldn't we allow a note for the "starting" point as well?

Most objects have short object names already (D123, M123, rExxxx, P123, L123, etc). These are unambiguous.

This seems like a great idea... what happened to this review? Was this feature abandoned?