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

{rumo_cli-0.2.2 → rumo_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: rumo-cli
-Version: 0.2.2
+Version: 0.4.0
 Summary: Your dev work, past, now and later: Markdown files, a terminal Timeline, and AI agents that keep it current
 Project-URL: Homepage, https://github.com/pedrobuzzi/rumo
 Project-URL: Issues, https://github.com/pedrobuzzi/rumo/issues
@@ -33,7 +33,7 @@ Timeline, and let your AI agent sessions keep it up to date while you work.
 
 Items can belong to a **group** (a project or initiative), shown as a label with its name on its
 color; color in rumo only ever means the group. One item is one line, plus its next step. rumo shows
-one horizon at a time (Now, or Past with `p`, or Later with `l`) in three views: the **Timeline**,
+one horizon at a time (`h` steps Now, Later, Past), named in a banner atop the list, in three views: the **Timeline**,
 **Projects** (one block per group) and **Repos** (one block per repository of the item's latest
 agent session). The interface is in English; the content (titles, notes, steps) is in your own
 language.
@@ -63,6 +63,10 @@ system language.
   /plugin install rumo@rumo
   ```
 
+  `/rumo` runs its `rumo` commands without asking. To let the agent run them without asking in later
+  answers too (to link an item it offered to create, for example), add `"Bash(rumo:*)"` to
+  `permissions.allow` in `~/.claude/settings.json`.
+
 - **Codex, Gemini CLI, Cursor, GitHub Copilot and other agents** that read `SKILL.md` files,
   simple mode (create items and ideas, list and search them; no automatic updates):
 
@@ -71,7 +75,9 @@ system language.
   ```
 
 **Update**: `uv tool upgrade rumo-cli` (or `pipx upgrade rumo-cli`, `brew upgrade rumo`), and
-`/plugin marketplace update rumo` in Claude Code.
+`/plugin marketplace update rumo` in Claude Code, then `/reload-plugins` in sessions already open.
+To get new plugin versions on their own, turn on auto-update for the `rumo` marketplace in `/plugin`
+(Marketplaces tab); the `rumo` command updates with your package manager.
 
 **Uninstall**: `/plugin uninstall rumo@rumo`, then `uv tool uninstall rumo-cli` (or
 `pipx uninstall rumo-cli`, `brew uninstall rumo`). Your items in `~/rumo/` are never touched.
@@ -83,15 +89,19 @@ system language.
 | Key | Action |
 |---|---|
 | ↑ ↓ | move through the list |
-| Tab | switch between the list, steps and sessions |
+| Tab | switch between the list, steps, PRs and sessions |
 | `v` | next view: Timeline, Projects, Repos (`1` `2` `3` go straight to one; rumo remembers it) |
-| `p` / `l` | show Past / Later; press again to go back to Now |
+| `h` | next horizon: Now, then Later, then Past, then Now again |
 | `s` | change status (1-5 picks directly) |
 | `g` | set the group or create one; inside, `r` renames, `c` recolors and `d` deletes the highlighted group (its items stay) |
 | `t` | toggle tags |
 | `n` | capture a new idea |
 | `e` | open the item in `$EDITOR` |
-| space | check or uncheck the selected step |
+| `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]` |
+| Enter, shift+↑ ↓, `d`, space | with the steps focused: edit, move, delete (asks first) or check the highlighted step; Esc goes back |
+| `x` | hide or show the done steps of every item (rumo remembers it) |
+| `p` | add a PR link to the selected item (a title may follow the link); in the dialog, Tab switches the state |
+| 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) |
 | `c` | copy the command that resumes the selected agent session |
 | `/` | filter by title, tag, group or text (Esc clears) |
 | `q` | quit |
@@ -106,12 +116,12 @@ system language.
 | `/rumo now` | List what is in progress, with the next step of each. |
 | `/rumo find <text>` | Search past, current and future items. |
 | `/rumo status` | Show where you left off on the linked item. |
-| `/rumo step <text>` | Add a step to the linked item. |
+| `/rumo step <text>` | Add a step to the linked item, or to the item it belongs to when none is linked. |
 | `/rumo park [reason]` | Pause the item with an accurate "Left off" and stop updating it here. |
 | `/rumo done` | Finish the item (checks the steps, asks first). |
 | `/rumo unlink` | Stop updating the item from this session. |
 
-`link`, `status`, `step`, `park` and `unlink` need Claude Code with the plugin, because they rely on
+`link`, `status`, `park` and `unlink` need Claude Code with the plugin, because they rely on
 its session id and hook. Other agents get the rest.
 
 When you create an item or an idea, the agent checks whether it belongs to an existing group. If
@@ -120,8 +130,30 @@ applies it only if you agree.
 
 Steps are the heart of an item: while a session is linked, the agent checks off what got done, adds
 what came up and keeps the next action as the first open step, after every response in which work
-happened. Left off is one line and Context at most three. `/clear` starts a new, unlinked session;
-`claude --resume <id>` picks the old one up again.
+happened. If a turn did work and no linked item changed, the plugin reminds the agent before the turn
+ends. Open steps are never deleted unless you ask, so half-done work stays in Now. One session can
+follow several topics: when you start something no linked item covers, the agent asks once whether to
+track it as a new item, add it as a step, or leave it out. Left off is one line and Context at most
+three. `/clear` starts a new, unlinked session; `claude --resume <id>` picks the old one up again.
+
+You can add, edit, move, check and delete steps in the Timeline too. On your next message, a linked
+session is told which steps changed since its last answer, so it neither redoes nor re-adds them, and
+it starts none of them unless you ask. When the agent finishes a step and more remain, it ends with
+the next one: an offer to start it, or a note that it is yours.
+
+Each item lists its pull requests (GitHub, GitLab, Bitbucket or any other link) with their state:
+open, draft, merged or closed. rumo finds them on its own: a PR a linked session opens (with
+`gh pr create`, `glab mr create` or a tool that creates PRs) goes into its item at the end of the turn,
+and while the Timeline is open, the GitHub CLI (`gh`, when installed and logged in) keeps their states
+current and adds the PRs opened from the branches the item's sessions worked on. The agent updates a
+state when it learns one, and you can add, edit, open and delete PRs in the Timeline too; a PR you
+delete is never added back. The list shows how many PRs of each item are still open.
+
+In a session without an item, the agent learns at the start what is in progress in that repository
+(up to three items, with their next step), so it can answer "what is left?"; `rumo now` lists
+everything in progress. Once that session edits files, the agent asks whether to track it. The first
+time it also asks whether to keep asking in future sessions (`ask_to_track` in the config). If you
+say no, it reminds you that the option exists every 15 days or 15 sessions.
 
 ## Item format
 
@@ -146,12 +178,17 @@ Users land on a protected page after logging out.
 - [ ] [manual] Ask for a PR review
 - [ ] [agent] e2e test for logout
 
+## PRs
+- [open] https://github.com/you/web-app/pull/42 Redirect home after logout
+
 ## Sessions
 - 2026-10-11 10:08 | web-app (main) | 7134aad0-4ba6-4583-9503-c08e98d28270 | /Users/you/repo/web-app
 ```
 
 - Statuses: `idea`, `doing`, `waiting`, `paused`, `done`. `done: <date>` is set when an item is finished.
 - Steps are `[agent]` (the AI can do it) or `[manual]` (you or someone else does it).
+- PRs are one link per line, with the state in brackets (`open`, `draft`, `merged`, `closed`; none when
+  unknown) and an optional title after the link.
 - An idea can be just the frontmatter; it grows when you start working on it.
 - A session line ending in `| closed` no longer updates the item.
 
@@ -165,14 +202,15 @@ folder = "~/rumo"
 language = "pt-BR"     # language of the content the agent writes; defaults to your system language
 tags = ["bug", "feature", "refactor", "research", "spike", "review",
         "infra", "deploy", "meeting", "docs", "support", "tech-debt"]
+ask_to_track = true    # offer rumo in agent sessions without an item; unset until you first answer
 
 [groups.auth]
 name = "Auth migration"
 color = "blue"         # blue, green, yellow, orange, red, magenta, purple, cyan
 ```
 
-Groups appear in the order of this file in every view. The last view is remembered in
-`state.json`, next to `config.toml`.
+Groups appear in the order of this file in every view. The last view, and when the agent last
+asked about tracking, are remembered in `state.json`, next to `config.toml`.
 
 `RUMO_DIR` and `RUMO_CONFIG` override the folder and the config path.
 

{rumo_cli-0.2.2 → rumo_cli-0.4.0}/README.md

@@ -12,7 +12,7 @@ Timeline, and let your AI agent sessions keep it up to date while you work.
 
 Items can belong to a **group** (a project or initiative), shown as a label with its name on its
 color; color in rumo only ever means the group. One item is one line, plus its next step. rumo shows
-one horizon at a time (Now, or Past with `p`, or Later with `l`) in three views: the **Timeline**,
+one horizon at a time (`h` steps Now, Later, Past), named in a banner atop the list, in three views: the **Timeline**,
 **Projects** (one block per group) and **Repos** (one block per repository of the item's latest
 agent session). The interface is in English; the content (titles, notes, steps) is in your own
 language.
@@ -42,6 +42,10 @@ system language.
   /plugin install rumo@rumo
   ```
 
+  `/rumo` runs its `rumo` commands without asking. To let the agent run them without asking in later
+  answers too (to link an item it offered to create, for example), add `"Bash(rumo:*)"` to
+  `permissions.allow` in `~/.claude/settings.json`.
+
 - **Codex, Gemini CLI, Cursor, GitHub Copilot and other agents** that read `SKILL.md` files,
   simple mode (create items and ideas, list and search them; no automatic updates):
 
@@ -50,7 +54,9 @@ system language.
   ```
 
 **Update**: `uv tool upgrade rumo-cli` (or `pipx upgrade rumo-cli`, `brew upgrade rumo`), and
-`/plugin marketplace update rumo` in Claude Code.
+`/plugin marketplace update rumo` in Claude Code, then `/reload-plugins` in sessions already open.
+To get new plugin versions on their own, turn on auto-update for the `rumo` marketplace in `/plugin`
+(Marketplaces tab); the `rumo` command updates with your package manager.
 
 **Uninstall**: `/plugin uninstall rumo@rumo`, then `uv tool uninstall rumo-cli` (or
 `pipx uninstall rumo-cli`, `brew uninstall rumo`). Your items in `~/rumo/` are never touched.
@@ -62,15 +68,19 @@ system language.
 | Key | Action |
 |---|---|
 | ↑ ↓ | move through the list |
-| Tab | switch between the list, steps and sessions |
+| Tab | switch between the list, steps, PRs and sessions |
 | `v` | next view: Timeline, Projects, Repos (`1` `2` `3` go straight to one; rumo remembers it) |
-| `p` / `l` | show Past / Later; press again to go back to Now |
+| `h` | next horizon: Now, then Later, then Past, then Now again |
 | `s` | change status (1-5 picks directly) |
 | `g` | set the group or create one; inside, `r` renames, `c` recolors and `d` deletes the highlighted group (its items stay) |
 | `t` | toggle tags |
 | `n` | capture a new idea |
 | `e` | open the item in `$EDITOR` |
-| space | check or uncheck the selected step |
+| `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]` |
+| Enter, shift+↑ ↓, `d`, space | with the steps focused: edit, move, delete (asks first) or check the highlighted step; Esc goes back |
+| `x` | hide or show the done steps of every item (rumo remembers it) |
+| `p` | add a PR link to the selected item (a title may follow the link); in the dialog, Tab switches the state |
+| 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) |
 | `c` | copy the command that resumes the selected agent session |
 | `/` | filter by title, tag, group or text (Esc clears) |
 | `q` | quit |
@@ -85,12 +95,12 @@ system language.
 | `/rumo now` | List what is in progress, with the next step of each. |
 | `/rumo find <text>` | Search past, current and future items. |
 | `/rumo status` | Show where you left off on the linked item. |
-| `/rumo step <text>` | Add a step to the linked item. |
+| `/rumo step <text>` | Add a step to the linked item, or to the item it belongs to when none is linked. |
 | `/rumo park [reason]` | Pause the item with an accurate "Left off" and stop updating it here. |
 | `/rumo done` | Finish the item (checks the steps, asks first). |
 | `/rumo unlink` | Stop updating the item from this session. |
 
-`link`, `status`, `step`, `park` and `unlink` need Claude Code with the plugin, because they rely on
+`link`, `status`, `park` and `unlink` need Claude Code with the plugin, because they rely on
 its session id and hook. Other agents get the rest.
 
 When you create an item or an idea, the agent checks whether it belongs to an existing group. If
@@ -99,8 +109,30 @@ applies it only if you agree.
 
 Steps are the heart of an item: while a session is linked, the agent checks off what got done, adds
 what came up and keeps the next action as the first open step, after every response in which work
-happened. Left off is one line and Context at most three. `/clear` starts a new, unlinked session;
-`claude --resume <id>` picks the old one up again.
+happened. If a turn did work and no linked item changed, the plugin reminds the agent before the turn
+ends. Open steps are never deleted unless you ask, so half-done work stays in Now. One session can
+follow several topics: when you start something no linked item covers, the agent asks once whether to
+track it as a new item, add it as a step, or leave it out. Left off is one line and Context at most
+three. `/clear` starts a new, unlinked session; `claude --resume <id>` picks the old one up again.
+
+You can add, edit, move, check and delete steps in the Timeline too. On your next message, a linked
+session is told which steps changed since its last answer, so it neither redoes nor re-adds them, and
+it starts none of them unless you ask. When the agent finishes a step and more remain, it ends with
+the next one: an offer to start it, or a note that it is yours.
+
+Each item lists its pull requests (GitHub, GitLab, Bitbucket or any other link) with their state:
+open, draft, merged or closed. rumo finds them on its own: a PR a linked session opens (with
+`gh pr create`, `glab mr create` or a tool that creates PRs) goes into its item at the end of the turn,
+and while the Timeline is open, the GitHub CLI (`gh`, when installed and logged in) keeps their states
+current and adds the PRs opened from the branches the item's sessions worked on. The agent updates a
+state when it learns one, and you can add, edit, open and delete PRs in the Timeline too; a PR you
+delete is never added back. The list shows how many PRs of each item are still open.
+
+In a session without an item, the agent learns at the start what is in progress in that repository
+(up to three items, with their next step), so it can answer "what is left?"; `rumo now` lists
+everything in progress. Once that session edits files, the agent asks whether to track it. The first
+time it also asks whether to keep asking in future sessions (`ask_to_track` in the config). If you
+say no, it reminds you that the option exists every 15 days or 15 sessions.
 
 ## Item format
 
@@ -125,12 +157,17 @@ Users land on a protected page after logging out.
 - [ ] [manual] Ask for a PR review
 - [ ] [agent] e2e test for logout
 
+## PRs
+- [open] https://github.com/you/web-app/pull/42 Redirect home after logout
+
 ## Sessions
 - 2026-10-11 10:08 | web-app (main) | 7134aad0-4ba6-4583-9503-c08e98d28270 | /Users/you/repo/web-app
 ```
 
 - Statuses: `idea`, `doing`, `waiting`, `paused`, `done`. `done: <date>` is set when an item is finished.
 - Steps are `[agent]` (the AI can do it) or `[manual]` (you or someone else does it).
+- PRs are one link per line, with the state in brackets (`open`, `draft`, `merged`, `closed`; none when
+  unknown) and an optional title after the link.
 - An idea can be just the frontmatter; it grows when you start working on it.
 - A session line ending in `| closed` no longer updates the item.
 
@@ -144,14 +181,15 @@ folder = "~/rumo"
 language = "pt-BR"     # language of the content the agent writes; defaults to your system language
 tags = ["bug", "feature", "refactor", "research", "spike", "review",
         "infra", "deploy", "meeting", "docs", "support", "tech-debt"]
+ask_to_track = true    # offer rumo in agent sessions without an item; unset until you first answer
 
 [groups.auth]
 name = "Auth migration"
 color = "blue"         # blue, green, yellow, orange, red, magenta, purple, cyan
 ```
 
-Groups appear in the order of this file in every view. The last view is remembered in
-`state.json`, next to `config.toml`.
+Groups appear in the order of this file in every view. The last view, and when the agent last
+asked about tracking, are remembered in `state.json`, next to `config.toml`.
 
 `RUMO_DIR` and `RUMO_CONFIG` override the folder and the config path.
 

{rumo_cli-0.2.2 → rumo_cli-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "rumo-cli"
-version = "0.2.2"
+version = "0.4.0"
 description = "Your dev work, past, now and later: Markdown files, a terminal Timeline, and AI agents that keep it current"
 readme = "README.md"
 requires-python = ">=3.11"