rumo-cli 0.3.0__tar.gz → 0.4.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: rumo-cli
3
- Version: 0.3.0
3
+ Version: 0.4.0
4
4
  Summary: Your dev work, past, now and later: Markdown files, a terminal Timeline, and AI agents that keep it current
5
5
  Project-URL: Homepage, https://github.com/pedrobuzzi/rumo
6
6
  Project-URL: Issues, https://github.com/pedrobuzzi/rumo/issues
@@ -63,6 +63,10 @@ system language.
63
63
  /plugin install rumo@rumo
64
64
  ```
65
65
 
66
+ `/rumo` runs its `rumo` commands without asking. To let the agent run them without asking in later
67
+ answers too (to link an item it offered to create, for example), add `"Bash(rumo:*)"` to
68
+ `permissions.allow` in `~/.claude/settings.json`.
69
+
66
70
  - **Codex, Gemini CLI, Cursor, GitHub Copilot and other agents** that read `SKILL.md` files,
67
71
  simple mode (create items and ideas, list and search them; no automatic updates):
68
72
 
@@ -85,7 +89,7 @@ To get new plugin versions on their own, turn on auto-update for the `rumo` mark
85
89
  | Key | Action |
86
90
  |---|---|
87
91
  | ↑ ↓ | move through the list |
88
- | Tab | switch between the list, steps and sessions |
92
+ | Tab | switch between the list, steps, PRs and sessions |
89
93
  | `v` | next view: Timeline, Projects, Repos (`1` `2` `3` go straight to one; rumo remembers it) |
90
94
  | `h` | next horizon: Now, then Later, then Past, then Now again |
91
95
  | `s` | change status (1-5 picks directly) |
@@ -93,7 +97,11 @@ To get new plugin versions on their own, turn on auto-update for the `rumo` mark
93
97
  | `t` | toggle tags |
94
98
  | `n` | capture a new idea |
95
99
  | `e` | open the item in `$EDITOR` |
96
- | space | check or uncheck the selected step |
100
+ | `a` | add a step to the selected item, after its open steps (below the highlighted one when the steps have focus); in the dialog, Tab switches `[agent]` and `[manual]` |
101
+ | Enter, shift+↑ ↓, `d`, space | with the steps focused: edit, move, delete (asks first) or check the highlighted step; Esc goes back |
102
+ | `x` | hide or show the done steps of every item (rumo remembers it) |
103
+ | `p` | add a PR link to the selected item (a title may follow the link); in the dialog, Tab switches the state |
104
+ | Enter, space, `e`, `d` | with the PRs focused: open the highlighted PR in the browser, change its state, edit it, or delete it (asks first) |
97
105
  | `c` | copy the command that resumes the selected agent session |
98
106
  | `/` | filter by title, tag, group or text (Esc clears) |
99
107
  | `q` | quit |
@@ -108,12 +116,12 @@ To get new plugin versions on their own, turn on auto-update for the `rumo` mark
108
116
  | `/rumo now` | List what is in progress, with the next step of each. |
109
117
  | `/rumo find <text>` | Search past, current and future items. |
110
118
  | `/rumo status` | Show where you left off on the linked item. |
111
- | `/rumo step <text>` | Add a step to the linked item. |
119
+ | `/rumo step <text>` | Add a step to the linked item, or to the item it belongs to when none is linked. |
112
120
  | `/rumo park [reason]` | Pause the item with an accurate "Left off" and stop updating it here. |
113
121
  | `/rumo done` | Finish the item (checks the steps, asks first). |
114
122
  | `/rumo unlink` | Stop updating the item from this session. |
115
123
 
116
- `link`, `status`, `step`, `park` and `unlink` need Claude Code with the plugin, because they rely on
124
+ `link`, `status`, `park` and `unlink` need Claude Code with the plugin, because they rely on
117
125
  its session id and hook. Other agents get the rest.
118
126
 
119
127
  When you create an item or an idea, the agent checks whether it belongs to an existing group. If
@@ -128,9 +136,24 @@ follow several topics: when you start something no linked item covers, the agent
128
136
  track it as a new item, add it as a step, or leave it out. Left off is one line and Context at most
129
137
  three. `/clear` starts a new, unlinked session; `claude --resume <id>` picks the old one up again.
130
138
 
131
- In a session without an item, once it edits files, the agent asks whether to track it. The first time
132
- it also asks whether to keep asking in future sessions (`ask_to_track` in the config). If you say no,
133
- it reminds you that the option exists every 15 days or 15 sessions.
139
+ You can add, edit, move, check and delete steps in the Timeline too. On your next message, a linked
140
+ session is told which steps changed since its last answer, so it neither redoes nor re-adds them, and
141
+ it starts none of them unless you ask. When the agent finishes a step and more remain, it ends with
142
+ the next one: an offer to start it, or a note that it is yours.
143
+
144
+ Each item lists its pull requests (GitHub, GitLab, Bitbucket or any other link) with their state:
145
+ open, draft, merged or closed. rumo finds them on its own: a PR a linked session opens (with
146
+ `gh pr create`, `glab mr create` or a tool that creates PRs) goes into its item at the end of the turn,
147
+ and while the Timeline is open, the GitHub CLI (`gh`, when installed and logged in) keeps their states
148
+ current and adds the PRs opened from the branches the item's sessions worked on. The agent updates a
149
+ state when it learns one, and you can add, edit, open and delete PRs in the Timeline too; a PR you
150
+ delete is never added back. The list shows how many PRs of each item are still open.
151
+
152
+ In a session without an item, the agent learns at the start what is in progress in that repository
153
+ (up to three items, with their next step), so it can answer "what is left?"; `rumo now` lists
154
+ everything in progress. Once that session edits files, the agent asks whether to track it. The first
155
+ time it also asks whether to keep asking in future sessions (`ask_to_track` in the config). If you
156
+ say no, it reminds you that the option exists every 15 days or 15 sessions.
134
157
 
135
158
  ## Item format
136
159
 
@@ -155,12 +178,17 @@ Users land on a protected page after logging out.
155
178
  - [ ] [manual] Ask for a PR review
156
179
  - [ ] [agent] e2e test for logout
157
180
 
181
+ ## PRs
182
+ - [open] https://github.com/you/web-app/pull/42 Redirect home after logout
183
+
158
184
  ## Sessions
159
185
  - 2026-10-11 10:08 | web-app (main) | 7134aad0-4ba6-4583-9503-c08e98d28270 | /Users/you/repo/web-app
160
186
  ```
161
187
 
162
188
  - Statuses: `idea`, `doing`, `waiting`, `paused`, `done`. `done: <date>` is set when an item is finished.
163
189
  - Steps are `[agent]` (the AI can do it) or `[manual]` (you or someone else does it).
190
+ - PRs are one link per line, with the state in brackets (`open`, `draft`, `merged`, `closed`; none when
191
+ unknown) and an optional title after the link.
164
192
  - An idea can be just the frontmatter; it grows when you start working on it.
165
193
  - A session line ending in `| closed` no longer updates the item.
166
194
 
@@ -42,6 +42,10 @@ system language.
42
42
  /plugin install rumo@rumo
43
43
  ```
44
44
 
45
+ `/rumo` runs its `rumo` commands without asking. To let the agent run them without asking in later
46
+ answers too (to link an item it offered to create, for example), add `"Bash(rumo:*)"` to
47
+ `permissions.allow` in `~/.claude/settings.json`.
48
+
45
49
  - **Codex, Gemini CLI, Cursor, GitHub Copilot and other agents** that read `SKILL.md` files,
46
50
  simple mode (create items and ideas, list and search them; no automatic updates):
47
51
 
@@ -64,7 +68,7 @@ To get new plugin versions on their own, turn on auto-update for the `rumo` mark
64
68
  | Key | Action |
65
69
  |---|---|
66
70
  | ↑ ↓ | move through the list |
67
- | Tab | switch between the list, steps and sessions |
71
+ | Tab | switch between the list, steps, PRs and sessions |
68
72
  | `v` | next view: Timeline, Projects, Repos (`1` `2` `3` go straight to one; rumo remembers it) |
69
73
  | `h` | next horizon: Now, then Later, then Past, then Now again |
70
74
  | `s` | change status (1-5 picks directly) |
@@ -72,7 +76,11 @@ To get new plugin versions on their own, turn on auto-update for the `rumo` mark
72
76
  | `t` | toggle tags |
73
77
  | `n` | capture a new idea |
74
78
  | `e` | open the item in `$EDITOR` |
75
- | space | check or uncheck the selected step |
79
+ | `a` | add a step to the selected item, after its open steps (below the highlighted one when the steps have focus); in the dialog, Tab switches `[agent]` and `[manual]` |
80
+ | Enter, shift+↑ ↓, `d`, space | with the steps focused: edit, move, delete (asks first) or check the highlighted step; Esc goes back |
81
+ | `x` | hide or show the done steps of every item (rumo remembers it) |
82
+ | `p` | add a PR link to the selected item (a title may follow the link); in the dialog, Tab switches the state |
83
+ | Enter, space, `e`, `d` | with the PRs focused: open the highlighted PR in the browser, change its state, edit it, or delete it (asks first) |
76
84
  | `c` | copy the command that resumes the selected agent session |
77
85
  | `/` | filter by title, tag, group or text (Esc clears) |
78
86
  | `q` | quit |
@@ -87,12 +95,12 @@ To get new plugin versions on their own, turn on auto-update for the `rumo` mark
87
95
  | `/rumo now` | List what is in progress, with the next step of each. |
88
96
  | `/rumo find <text>` | Search past, current and future items. |
89
97
  | `/rumo status` | Show where you left off on the linked item. |
90
- | `/rumo step <text>` | Add a step to the linked item. |
98
+ | `/rumo step <text>` | Add a step to the linked item, or to the item it belongs to when none is linked. |
91
99
  | `/rumo park [reason]` | Pause the item with an accurate "Left off" and stop updating it here. |
92
100
  | `/rumo done` | Finish the item (checks the steps, asks first). |
93
101
  | `/rumo unlink` | Stop updating the item from this session. |
94
102
 
95
- `link`, `status`, `step`, `park` and `unlink` need Claude Code with the plugin, because they rely on
103
+ `link`, `status`, `park` and `unlink` need Claude Code with the plugin, because they rely on
96
104
  its session id and hook. Other agents get the rest.
97
105
 
98
106
  When you create an item or an idea, the agent checks whether it belongs to an existing group. If
@@ -107,9 +115,24 @@ follow several topics: when you start something no linked item covers, the agent
107
115
  track it as a new item, add it as a step, or leave it out. Left off is one line and Context at most
108
116
  three. `/clear` starts a new, unlinked session; `claude --resume <id>` picks the old one up again.
109
117
 
110
- In a session without an item, once it edits files, the agent asks whether to track it. The first time
111
- it also asks whether to keep asking in future sessions (`ask_to_track` in the config). If you say no,
112
- it reminds you that the option exists every 15 days or 15 sessions.
118
+ You can add, edit, move, check and delete steps in the Timeline too. On your next message, a linked
119
+ session is told which steps changed since its last answer, so it neither redoes nor re-adds them, and
120
+ it starts none of them unless you ask. When the agent finishes a step and more remain, it ends with
121
+ the next one: an offer to start it, or a note that it is yours.
122
+
123
+ Each item lists its pull requests (GitHub, GitLab, Bitbucket or any other link) with their state:
124
+ open, draft, merged or closed. rumo finds them on its own: a PR a linked session opens (with
125
+ `gh pr create`, `glab mr create` or a tool that creates PRs) goes into its item at the end of the turn,
126
+ and while the Timeline is open, the GitHub CLI (`gh`, when installed and logged in) keeps their states
127
+ current and adds the PRs opened from the branches the item's sessions worked on. The agent updates a
128
+ state when it learns one, and you can add, edit, open and delete PRs in the Timeline too; a PR you
129
+ delete is never added back. The list shows how many PRs of each item are still open.
130
+
131
+ In a session without an item, the agent learns at the start what is in progress in that repository
132
+ (up to three items, with their next step), so it can answer "what is left?"; `rumo now` lists
133
+ everything in progress. Once that session edits files, the agent asks whether to track it. The first
134
+ time it also asks whether to keep asking in future sessions (`ask_to_track` in the config). If you
135
+ say no, it reminds you that the option exists every 15 days or 15 sessions.
113
136
 
114
137
  ## Item format
115
138
 
@@ -134,12 +157,17 @@ Users land on a protected page after logging out.
134
157
  - [ ] [manual] Ask for a PR review
135
158
  - [ ] [agent] e2e test for logout
136
159
 
160
+ ## PRs
161
+ - [open] https://github.com/you/web-app/pull/42 Redirect home after logout
162
+
137
163
  ## Sessions
138
164
  - 2026-10-11 10:08 | web-app (main) | 7134aad0-4ba6-4583-9503-c08e98d28270 | /Users/you/repo/web-app
139
165
  ```
140
166
 
141
167
  - Statuses: `idea`, `doing`, `waiting`, `paused`, `done`. `done: <date>` is set when an item is finished.
142
168
  - Steps are `[agent]` (the AI can do it) or `[manual]` (you or someone else does it).
169
+ - PRs are one link per line, with the state in brackets (`open`, `draft`, `merged`, `closed`; none when
170
+ unknown) and an optional title after the link.
143
171
  - An idea can be just the frontmatter; it grows when you start working on it.
144
172
  - A session line ending in `| closed` no longer updates the item.
145
173
 
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "rumo-cli"
3
- version = "0.3.0"
3
+ version = "0.4.0"
4
4
  description = "Your dev work, past, now and later: Markdown files, a terminal Timeline, and AI agents that keep it current"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.11"