Konstantin Fickel
49cd9bcfa0
- Use collections.abc.Generator/Iterable instead of deprecated typing imports - Replace Optional with union syntax (X | None) - Add explicit type annotations to eliminate reportUnknownVariableType - Use typing.cast for untyped mistletoe attributes (content, level, line_number) - Replace mutable default arguments with None defaults (reportCallInDefaultInitializer) - Add ClassVar annotation for model_config (reportIncompatibleVariableOverride) - Add @override decorator for settings_customise_sources (reportImplicitOverride) - Annotate class attributes in Tag (reportUnannotatedClassAttribute) - Add parameter type annotations in test (reportMissingParameterType) - Assign unused call result to _ (reportUnusedCallResult) |
||
|---|---|---|
| .forgejo/workflows | ||
| .vscode | ||
| src | ||
| test | ||
| .envrc | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| .python-version | ||
| flake.lock | ||
| flake.nix | ||
| LICENSE.md | ||
| pyproject.toml | ||
| README.md | ||
| renovate.json | ||
| uv.lock | ||
streamer
Streamer is a personal knowledge management and time-tracking CLI tool. It organizes time-ordered markdown files using @tag annotations, letting you manage tasks, track time, and query your notes from the terminal.
Core Concepts
- Shards — Sections of markdown files, organized hierarchically by headings. Each shard can contain markers, tags, and nested child shards.
- Markers — Special
@tagslike@Task,@Done,@Waiting, or@Timesheetthat give shards semantic meaning and place them into dimensions. - Dimensions — Classification axes (e.g. task state, project, timesheet) that categorize shards. Some dimensions propagate to child shards.
File Format
Markdown files are named with a timestamp: YYYYMMDD-HHMMSS [markers].md
For example: 20260131-210000 Task Streamer.md
Within files, @-prefixed markers at the beginning of paragraphs or headings define how a shard is categorized.
Commands
streamer/streamer new— Create a new timestamped markdown entry, opening your editorstreamer todo— Show all open tasks (shards with@Taskmarkers)streamer edit [number]— Edit a stream file by index (most recent first)streamer timesheet— Generate time reports from@Timesheetmarkers
Configuration
Streamer reads its configuration from ~/.config/streamer/config.yaml (XDG standard). The main setting is base_folder, which points to the directory containing your stream files (defaults to the current working directory).
Usage
Running streamer opens your editor to create a new entry. After saving, the file is renamed based on its timestamp and any markers found in the content.
Running streamer todo finds all shards marked as open tasks and displays them as rich-formatted panels in your terminal.