feat(tui): add logs-path CLI command and update README

Author: alxhall

justfile

@@ -103,3 +103,7 @@ tui-version:
 # Show toki-tui session and Milltime status
 tui-status:
     cd toki-tui && cargo run -- status
+
+# Print the log notes directory path
+tui-logs:
+    cd toki-tui && cargo run -- logs-path

toki-tui/README.md

@@ -16,45 +16,38 @@ just tui-dev
 
 # Clear saved session
 just tui-logout
-
-# Print config path and create default config if missing
-just tui-config
 ```
 
-## Configuration
-
-Config file: `~/.config/toki-tui/config.toml`
-
-Run `just tui-config` (or `cargo run -- config-path`) to print the path and create the file with defaults if it does not exist.
+## CLI Commands
 
-All keys are optional. If the file is missing, built-in defaults are used.
-
-### Environment variables
+All commands are available via the binary directly (`toki-tui <command>`) or through `just`:
 
-You can override config values with environment variables.
+| Command | `just` recipe | Description |
+| -------------- | -------------- | -------------------------------------------------- |
+| `run` | `just tui` | Run against the real toki-api server |
+| `dev` | `just tui-dev` | Run in dev mode with in-memory mock data |
+| `login` | `just tui-login` | Authenticate via browser OAuth |
+| `logout` | `just tui-logout` | Clear saved session and Milltime cookies |
+| `status` | `just tui-status` | Show current login and Milltime session status |
+| `config-path` | `just tui-config` | Print config path; create default file if missing |
+| `logs-path` | `just tui-logs` | Print the log notes directory path |
+| `version` | `just tui-version` | Print the current version |
 
-- Prefix: `TOKI_TUI_`
-- Key format: uppercase snake case
-- Nested keys (if added later): use `__` as separator
+## Configuration
 
-Current variables:
+Config file: `~/.config/toki-tui/config.toml`
 
-```bash
-TOKI_TUI_API_URL="http://localhost:8080"
-TOKI_TUI_GIT_DEFAULT_PREFIX="Development"
-TOKI_TUI_TASK_FILTER="+work project:Toki"
-TOKI_TUI_AUTO_RESIZE_TIMER=true
-```
+Run `just tui-config` (or `toki-tui config-path`) to print the path and create the file with defaults if it does not exist.
 
-Environment variables override values from `config.toml`.
+All keys are optional. If the file is missing, built-in defaults are used.
 
 ```toml
 # URL of the toki-api server. Defaults to the production instance.
 api_url = "https://toki-api.spinit.se"
 
 # Prefix used when converting a git branch name to a time entry note,
 # when no conventional commit prefix (feat/fix/etc.) or ticket number is found.
-# Example: branch "branding/redesign" → "Utveckling: branding/redesign"
+# Example: branch "branding/redesign" → "Development: branding/redesign"
 git_default_prefix = "Utveckling"
 
 # Taskwarrior filter tokens prepended before `status:pending export`.
@@ -66,6 +59,32 @@ task_filter = ""
 # When true (default), the timer grows large when running and shrinks when stopped.
 # Set to false to keep the timer at a fixed (normal) size at all times.
 auto_resize_timer = true
+
+# Entry templates — pre-fill project, activity and note from a picker (press T).
+# [[template]] sections can be repeated.
+[[template]]
+name = "My project"
+project = "My Project"
+activity = "Development"
+note = "Working on stuff"
+```
+
+### Entry templates
+
+Define reusable presets in `config.toml`. In the timer view, press `T` to open the template picker and select one to pre-fill the current entry.
+
+### Environment variables
+
+Environment variables override values from `config.toml`.
+
+- Prefix: `TOKI_TUI_`
+- Key format: uppercase snake case
+
+```bash
+TOKI_TUI_API_URL="http://localhost:8080"
+TOKI_TUI_GIT_DEFAULT_PREFIX="Development"
+TOKI_TUI_TASK_FILTER="+work project:Toki"
+TOKI_TUI_AUTO_RESIZE_TIMER=true
 ```
 
 ### Example: local dev setup
@@ -76,33 +95,71 @@ git_default_prefix = "Development"
 task_filter = "+work"
 ```
 
-## Testing
+## Log notes
+
+Attach a freeform markdown log file to any time entry. Log files are stored in `~/.local/share/toki-tui/logs/` and linked to entries via a tag embedded in the note (`[log:XXXXXX]`). The tag is hidden in all display locations — only the clean summary is shown.
+
+Run `just tui-logs` (or `toki-tui logs-path`) to print the log directory path.
+
+## Key bindings
+
+### Timer view
+
+| Key | Action |
+| -------------------- | ----------------------------- |
+| `Space` | Start / stop timer |
+| `Ctrl+S` | Save (with options) |
+| `Ctrl+R` | Resume last entry |
+| `Ctrl+X` | Clear current entry |
+| `Enter` | Edit description |
+| `P` | Edit project / activity |
+| `N` | Edit note (description editor) |
+| `T` | Open template picker |
+| `H` | Switch to history view |
+| `S` | Switch to statistics view |
+| `X` | Toggle timer size |
+| `Z` | Zen mode (hide UI chrome) |
+| `Tab / ↑↓ / j/k` | Navigate |
+| `Q` | Quit |
+
+### Description editor (note / `N`)
+
+| Key | Action |
+| -------------------- | ----------------------------- |
+| `Ctrl+L` | Add / edit log file |
+| `Ctrl+R` | Remove linked log file |
+| `Ctrl+D` | Change working directory |
+| `Ctrl+G` | Git: copy/paste branch or commit |
+| `Ctrl+T` | Taskwarrior: pick a task |
+| `Ctrl+X` | Clear note |
+| `Ctrl+←/→` | Word-boundary navigation |
+| `Ctrl+Backspace` | Delete word back |
+| `Enter` | Confirm |
+| `Esc` | Cancel |
+
+### History view
+
+| Key | Action |
+| -------------------- | ----------------------------- |
+| `↑↓` | Navigate entries |
+| `Enter` | Edit entry |
+| `Ctrl+R` | Resume entry (copy to timer) |
+| `Ctrl+L` | Open linked log file |
+| `H / Esc` | Back to timer view |
+| `Q` | Quit |
+
+**While editing a history entry:**
+
+| Key | Action |
+| -------------------- | ----------------------------- |
+| `Tab` | Next field |
+| `P / A` | Change project / activity |
+| `Esc` | Save and exit edit mode |
 
-Run the TUI test suite with:
+## Testing
 
 ```bash
-cargo test -p toki-tui
+SQLX_OFFLINE=true cargo test -p toki-tui
 ```
 
-The current tests focus on the most stable and useful layers first:
-
-- app and state behavior
-- parsing and text input helpers
-- runtime action handling with the dev backend
-- focused Ratatui render assertions for important UI states
-
-## Standard key bindings
-
-| Key            | Action             |
-| -------------- | ------------------ |
-| `Space`          | Start / stop timer |
-| `Ctrl+S`         | Save (options)     |
-| `Ctrl+X`         | Clear              |
-| `Tab / ↑↓ / j/k` | Navigate           |
-| `H`              | History view       |
-| `P`              | Project            |
-| `N`              | Note               |
-| `T`              | Toggle timer size  |
-| `S`              | Stats              |
-| `Esc`            | Exit / cancel      |
-| `Q`              | Quit               |
+Tests cover app and state behavior, text input helpers, runtime action handling, and focused Ratatui render assertions.

toki-tui/src/cli.rs

@@ -20,6 +20,8 @@ pub enum Commands {
     Logout,
     /// Print config path and create default file if missing
     ConfigPath,
+    /// Print the log notes directory path
+    LogsPath,
     /// Print the current version
     Version,
     /// Show current login and Milltime session status

toki-tui/src/main.rs

@@ -32,6 +32,10 @@ async fn main() -> Result<()> {
             let path = config::TokiConfig::ensure_exists()?;
             println!("{}", path.display());
         }
+        Commands::LogsPath => {
+            let path = log_notes::log_dir()?;
+            println!("{}", path.display());
+        }
         Commands::Version => {
             println!("{}", env!("CARGO_PKG_VERSION"));
         }