simple-project-tracker 1.0.0__tar.gz

simple_project_tracker-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MattFor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

simple_project_tracker-1.0.0/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: simple-project-tracker
+Version: 1.0.0
+Summary: Simple project tracker
+Author-email: MattFor <mattfor@relaxy.xyz>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/MattFor/tracker
+Project-URL: Source, https://github.com/MattFor/tracker
+Project-URL: Mirror, https://codeberg.org/MattFor/tracker
+Project-URL: Issues, https://github.com/MattFor/tracker/issues
+Project-URL: Changelog, https://github.com/MattFor/tracker/blob/master/CHANGELOG.md
+Keywords: cli,projects,git,tracker
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# simple-project-tracker
+
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+A simple, but very customizable tracker to keep track of your projects, their states and
+your notes on them.
+
+```
+TID | ID | NAME                          | STATUS  | LAST TOUCHED | NOTE
+--- | -- | ----------------------------- | ------- | ------------ | ---------------------
+1   | 8  | tracker                       | dev     | 1m ago       | release 1.0.0 today
+2   | 3  | von-neumann-machine-simulator | dev     | 23m ago      | review saturday
+3   | 26 | discord-profile-studio        | stable  | 1h ago
+```
+
+## Contents
+
+- [Install](#install)
+- [Commands](#commands)
+- [Selecting projects](#selecting-projects)
+- [Configuration](#configuration)
+- [Development](#development)
+- [License](#license)
+
+## Install
+
+```sh
+./install.sh             # ~/.local
+sudo ./install.sh        # /usr/local
+./install.sh --daemon    # also install the daemon autostart entry
+./install.sh --uninstall
+```
+
+Python 3.11+. Then `t init ~/(your project directory)` to fill the database.
+
+## Commands
+
+| Command      | Aliases           | What it does                                                         |
+|--------------|-------------------|----------------------------------------------------------------------|
+| `list`       | `l`, `ls`         | List projects, with search, regex, filters and setting overrides     |
+| `check`      | `c`, `cc`, `info` | Everything about a project: git state, size, language, version, note |
+| `add`        | `a`               | Track a project, or scan a directory and track what is inside        |
+| `remove`     | `rm`, `r`, `del`  | Stop tracking projects (files untouched)                             |
+| `forget`     | `ignore`          | Stop tracking and keep scans from finding it again                   |
+| `edit`       | `e`               | Change a `status` or a `note`                                        |
+| `note`       | `n`, `sn`         | Set a note without naming the field                                  |
+| `status`     | `st`, `ss`        | List statuses, set one, or move every project from one to another    |
+| `init`       | `i`, `scan`       | Scan a directory and merge the result into the database              |
+| `path`       | `p`, `where`      | Print a project's path, e.g. `cd "$(t path tracker)"`                |
+| `undo`       | `u`, `revert`     | Take back the last change, undo again to put it back                 |
+| `stats`      | `summary`         | Totals, a breakdown by status, most and least recently touched       |
+| `settings`   | `s`, `config`     | Show, edit, get or set the configuration                             |
+| `completion` |                   | Print a shell completion script for bash, zsh or fish                |
+| `daemon`     | `d`, `bg`         | `start`, `stop`, `restart`, `status`, `log`, `run`                   |
+
+The project goes before or after the command, whichever reads better, and a command fuses
+with its own action:
+
+```sh
+t 12 es blocked        # edit status  also: t edit 12 status blocked
+t 12 sn review sunday  # set note     also: t note 12 review sunday
+t dst                  # daemon status
+t sset ll 30           # settings set display.list_limit 30
+```
+
+A bare word defaults to a project lookup.
+
+```sh
+t tra          # the check view for tracker
+t stable       # nothing is called that, so every stable project
+t all          # everything, no limit
+```
+
+For more information do: `t help`, `t help <command>` or `t help <topic>`. The full guide
+is within `man tracker`.
+
+## Selecting projects
+
+| Selector    | Means                                                     |
+|-------------|-----------------------------------------------------------|
+| `12`        | ID or TID 12                                              |
+| `i:12`      | The permanent ID, `id:` and `#12` too                     |
+| `t:12`      | The temporary ID, `tid:`, `@12` and `:12` too             |
+| `3-7`,`5+3` | A range, either direction, or a project and the next few  |
+| `s:blocked` | Every project with that status, `st:` and `status:` too   |
+| `name`      | Exact or partial name, or a path, tab completion included |
+| `all`       | Every tracked project                                     |
+
+A temporary ID is the index of the latest output.
+
+When a partial name matches several projects, it's settled by
+`projects.conflict_resolution_preference`.
+
+## Configuration
+
+```sh
+t settings                    # everything (default deviations marked)
+t settings edit               # open in $EDITOR
+t sset list_limit 30          # rewrites that one line
+t list ll=5 rt=true           # override for one command only
+```
+
+A setting can be named in full, by its bare name, by a prefix, by the start of every word
+or by its initials, with the section shortening the same way: `display.list_limit`,
+`list_limit`, `list_lim`, `l_l`, `ll`, `d.ll`. Ambiguities are reported.
+
+| Setting                             | What it does                                                |
+|-------------------------------------|-------------------------------------------------------------|
+| `display.filter`                    | Filters every listing, e.g. `["-s:archive"]`                |
+| `display.columns`, `display.format` | Which columns, or a row layout of your own                  |
+| `display.relative_times`            | `2 days ago` instead of a timestamp                         |
+| `display.name_max_width`            | Shorten long names, `truncate` or `abbreviate`              |
+| `sorting.by`, `sorting.direction`   | `last_touched`, `last_used`, `name`, `status`, `id`, `path` |
+| `projects.ignore`, `.ignore_files`  | Directories and files that never count as your own work     |
+| `projects.auto_status`              | Status from how long ago a project was touched              |
+| `scan.detect_moves`                 | A moved project keeps its entry instead of looking deleted  |
+| `daemon.paths`, `daemon.interval`   | What the background scanner watches, and how often          |
+
+Notes can colour themselves: `t note 12 {red}broken{/} since friday`.
+
+## Development
+
+```sh
+make dev      # editable install plus ruff, basedpyright, pytest
+make check    # format, lint, types and tests (what CI runs)
+```
+
+## Disclosure
+
+LLMs were used to:
+
+- write the help section
+- write the man page
+- check for critical issues and annotation errors
+
+HOWEVER, the output was then manually reviewed and issues were fixed by a human.
+
+## License
+
+MIT [LICENSE](LICENSE).  
+By MattFor.

simple_project_tracker-1.0.0/README.md

@@ -0,0 +1,142 @@
+# simple-project-tracker
+
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+A simple, but very customizable tracker to keep track of your projects, their states and
+your notes on them.
+
+```
+TID | ID | NAME                          | STATUS  | LAST TOUCHED | NOTE
+--- | -- | ----------------------------- | ------- | ------------ | ---------------------
+1   | 8  | tracker                       | dev     | 1m ago       | release 1.0.0 today
+2   | 3  | von-neumann-machine-simulator | dev     | 23m ago      | review saturday
+3   | 26 | discord-profile-studio        | stable  | 1h ago
+```
+
+## Contents
+
+- [Install](#install)
+- [Commands](#commands)
+- [Selecting projects](#selecting-projects)
+- [Configuration](#configuration)
+- [Development](#development)
+- [License](#license)
+
+## Install
+
+```sh
+./install.sh             # ~/.local
+sudo ./install.sh        # /usr/local
+./install.sh --daemon    # also install the daemon autostart entry
+./install.sh --uninstall
+```
+
+Python 3.11+. Then `t init ~/(your project directory)` to fill the database.
+
+## Commands
+
+| Command      | Aliases           | What it does                                                         |
+|--------------|-------------------|----------------------------------------------------------------------|
+| `list`       | `l`, `ls`         | List projects, with search, regex, filters and setting overrides     |
+| `check`      | `c`, `cc`, `info` | Everything about a project: git state, size, language, version, note |
+| `add`        | `a`               | Track a project, or scan a directory and track what is inside        |
+| `remove`     | `rm`, `r`, `del`  | Stop tracking projects (files untouched)                             |
+| `forget`     | `ignore`          | Stop tracking and keep scans from finding it again                   |
+| `edit`       | `e`               | Change a `status` or a `note`                                        |
+| `note`       | `n`, `sn`         | Set a note without naming the field                                  |
+| `status`     | `st`, `ss`        | List statuses, set one, or move every project from one to another    |
+| `init`       | `i`, `scan`       | Scan a directory and merge the result into the database              |
+| `path`       | `p`, `where`      | Print a project's path, e.g. `cd "$(t path tracker)"`                |
+| `undo`       | `u`, `revert`     | Take back the last change, undo again to put it back                 |
+| `stats`      | `summary`         | Totals, a breakdown by status, most and least recently touched       |
+| `settings`   | `s`, `config`     | Show, edit, get or set the configuration                             |
+| `completion` |                   | Print a shell completion script for bash, zsh or fish                |
+| `daemon`     | `d`, `bg`         | `start`, `stop`, `restart`, `status`, `log`, `run`                   |
+
+The project goes before or after the command, whichever reads better, and a command fuses
+with its own action:
+
+```sh
+t 12 es blocked        # edit status  also: t edit 12 status blocked
+t 12 sn review sunday  # set note     also: t note 12 review sunday
+t dst                  # daemon status
+t sset ll 30           # settings set display.list_limit 30
+```
+
+A bare word defaults to a project lookup.
+
+```sh
+t tra          # the check view for tracker
+t stable       # nothing is called that, so every stable project
+t all          # everything, no limit
+```
+
+For more information do: `t help`, `t help <command>` or `t help <topic>`. The full guide
+is within `man tracker`.
+
+## Selecting projects
+
+| Selector    | Means                                                     |
+|-------------|-----------------------------------------------------------|
+| `12`        | ID or TID 12                                              |
+| `i:12`      | The permanent ID, `id:` and `#12` too                     |
+| `t:12`      | The temporary ID, `tid:`, `@12` and `:12` too             |
+| `3-7`,`5+3` | A range, either direction, or a project and the next few  |
+| `s:blocked` | Every project with that status, `st:` and `status:` too   |
+| `name`      | Exact or partial name, or a path, tab completion included |
+| `all`       | Every tracked project                                     |
+
+A temporary ID is the index of the latest output.
+
+When a partial name matches several projects, it's settled by
+`projects.conflict_resolution_preference`.
+
+## Configuration
+
+```sh
+t settings                    # everything (default deviations marked)
+t settings edit               # open in $EDITOR
+t sset list_limit 30          # rewrites that one line
+t list ll=5 rt=true           # override for one command only
+```
+
+A setting can be named in full, by its bare name, by a prefix, by the start of every word
+or by its initials, with the section shortening the same way: `display.list_limit`,
+`list_limit`, `list_lim`, `l_l`, `ll`, `d.ll`. Ambiguities are reported.
+
+| Setting                             | What it does                                                |
+|-------------------------------------|-------------------------------------------------------------|
+| `display.filter`                    | Filters every listing, e.g. `["-s:archive"]`                |
+| `display.columns`, `display.format` | Which columns, or a row layout of your own                  |
+| `display.relative_times`            | `2 days ago` instead of a timestamp                         |
+| `display.name_max_width`            | Shorten long names, `truncate` or `abbreviate`              |
+| `sorting.by`, `sorting.direction`   | `last_touched`, `last_used`, `name`, `status`, `id`, `path` |
+| `projects.ignore`, `.ignore_files`  | Directories and files that never count as your own work     |
+| `projects.auto_status`              | Status from how long ago a project was touched              |
+| `scan.detect_moves`                 | A moved project keeps its entry instead of looking deleted  |
+| `daemon.paths`, `daemon.interval`   | What the background scanner watches, and how often          |
+
+Notes can colour themselves: `t note 12 {red}broken{/} since friday`.
+
+## Development
+
+```sh
+make dev      # editable install plus ruff, basedpyright, pytest
+make check    # format, lint, types and tests (what CI runs)
+```
+
+## Disclosure
+
+LLMs were used to:
+
+- write the help section
+- write the man page
+- check for critical issues and annotation errors
+
+HOWEVER, the output was then manually reviewed and issues were fixed by a human.
+
+## License
+
+MIT [LICENSE](LICENSE).  
+By MattFor.

simple_project_tracker-1.0.0/pyproject.toml

@@ -0,0 +1,111 @@
+[build-system]
+requires = ["setuptools>=77.0.3", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "simple-project-tracker"
+version = "1.0.0"
+description = "Simple project tracker"
+readme = "README.md"
+requires-python = ">=3.11"
+keywords = ["cli", "projects", "git", "tracker"]
+
+authors = [
+    { name = "MattFor", email = "mattfor@relaxy.xyz" }
+]
+
+license = "MIT"
+license-files = ["LICENSE"]
+
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS :: MacOS X",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+    "Typing :: Typed",
+]
+
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/MattFor/tracker"
+Source = "https://github.com/MattFor/tracker"
+Mirror = "https://codeberg.org/MattFor/tracker"
+Issues = "https://github.com/MattFor/tracker/issues"
+Changelog = "https://github.com/MattFor/tracker/blob/master/CHANGELOG.md"
+
+[project.scripts]
+tracker = "tracker.cli.app:main"
+t = "tracker.cli.app:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["tracker*"]
+
+[tool.setuptools.package-data]
+tracker = ["py.typed", "share/*.toml", "share/*.txt", "share/completion.*"]
+
+[dependency-groups]
+dev = [
+    "ruff",
+    "basedpyright",
+    "pytest>=9.0.2"
+]
+
+[tool.ruff]
+line-length = 90
+indent-width = 4
+
+[tool.ruff.format]
+indent-style = "tab"
+quote-style = "double"
+line-ending = "auto"
+skip-magic-trailing-comma = false
+
+[tool.ruff.lint]
+select = [
+    "E4", "E7", "E9", # pycodestyle: real mistakes, not whitespace taste
+    "F", # pyflakes
+    "B", # bugbear
+    "C4", # comprehensions
+    "PIE", # misc lint
+    "SIM", # simplify
+    "UP", # pyupgrade
+    "ARG", # unused arguments
+    "PLE", "PLW", # pylint errors and warnings
+    "FURB", # modernisation
+    "RUF", # ruff specific
+]
+
+[tool.ruff.lint.pycodestyle]
+max-line-length = 90
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--strict-markers --strict-config"
+xfail_strict = true
+
+[tool.basedpyright]
+include = ["tracker", "tests", "main.py"]
+exclude = ["**/__pycache__", ".venv", "build", "dist"]
+
+pythonVersion = "3.12"
+
+reportAny = false
+reportExplicitAny = false
+reportPrivateUsage = false
+reportImportCycles = false
+reportUnknownMemberType = false
+reportUnknownArgumentType = false
+reportUnknownVariableType = false
+reportUnknownParameterType = false

simple_project_tracker-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

simple_project_tracker-1.0.0/simple_project_tracker.egg-info/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: simple-project-tracker
+Version: 1.0.0
+Summary: Simple project tracker
+Author-email: MattFor <mattfor@relaxy.xyz>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/MattFor/tracker
+Project-URL: Source, https://github.com/MattFor/tracker
+Project-URL: Mirror, https://codeberg.org/MattFor/tracker
+Project-URL: Issues, https://github.com/MattFor/tracker/issues
+Project-URL: Changelog, https://github.com/MattFor/tracker/blob/master/CHANGELOG.md
+Keywords: cli,projects,git,tracker
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# simple-project-tracker
+
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+A simple, but very customizable tracker to keep track of your projects, their states and
+your notes on them.
+
+```
+TID | ID | NAME                          | STATUS  | LAST TOUCHED | NOTE
+--- | -- | ----------------------------- | ------- | ------------ | ---------------------
+1   | 8  | tracker                       | dev     | 1m ago       | release 1.0.0 today
+2   | 3  | von-neumann-machine-simulator | dev     | 23m ago      | review saturday
+3   | 26 | discord-profile-studio        | stable  | 1h ago
+```
+
+## Contents
+
+- [Install](#install)
+- [Commands](#commands)
+- [Selecting projects](#selecting-projects)
+- [Configuration](#configuration)
+- [Development](#development)
+- [License](#license)
+
+## Install
+
+```sh
+./install.sh             # ~/.local
+sudo ./install.sh        # /usr/local
+./install.sh --daemon    # also install the daemon autostart entry
+./install.sh --uninstall
+```
+
+Python 3.11+. Then `t init ~/(your project directory)` to fill the database.
+
+## Commands
+
+| Command      | Aliases           | What it does                                                         |
+|--------------|-------------------|----------------------------------------------------------------------|
+| `list`       | `l`, `ls`         | List projects, with search, regex, filters and setting overrides     |
+| `check`      | `c`, `cc`, `info` | Everything about a project: git state, size, language, version, note |
+| `add`        | `a`               | Track a project, or scan a directory and track what is inside        |
+| `remove`     | `rm`, `r`, `del`  | Stop tracking projects (files untouched)                             |
+| `forget`     | `ignore`          | Stop tracking and keep scans from finding it again                   |
+| `edit`       | `e`               | Change a `status` or a `note`                                        |
+| `note`       | `n`, `sn`         | Set a note without naming the field                                  |
+| `status`     | `st`, `ss`        | List statuses, set one, or move every project from one to another    |
+| `init`       | `i`, `scan`       | Scan a directory and merge the result into the database              |
+| `path`       | `p`, `where`      | Print a project's path, e.g. `cd "$(t path tracker)"`                |
+| `undo`       | `u`, `revert`     | Take back the last change, undo again to put it back                 |
+| `stats`      | `summary`         | Totals, a breakdown by status, most and least recently touched       |
+| `settings`   | `s`, `config`     | Show, edit, get or set the configuration                             |
+| `completion` |                   | Print a shell completion script for bash, zsh or fish                |
+| `daemon`     | `d`, `bg`         | `start`, `stop`, `restart`, `status`, `log`, `run`                   |
+
+The project goes before or after the command, whichever reads better, and a command fuses
+with its own action:
+
+```sh
+t 12 es blocked        # edit status  also: t edit 12 status blocked
+t 12 sn review sunday  # set note     also: t note 12 review sunday
+t dst                  # daemon status
+t sset ll 30           # settings set display.list_limit 30
+```
+
+A bare word defaults to a project lookup.
+
+```sh
+t tra          # the check view for tracker
+t stable       # nothing is called that, so every stable project
+t all          # everything, no limit
+```
+
+For more information do: `t help`, `t help <command>` or `t help <topic>`. The full guide
+is within `man tracker`.
+
+## Selecting projects
+
+| Selector    | Means                                                     |
+|-------------|-----------------------------------------------------------|
+| `12`        | ID or TID 12                                              |
+| `i:12`      | The permanent ID, `id:` and `#12` too                     |
+| `t:12`      | The temporary ID, `tid:`, `@12` and `:12` too             |
+| `3-7`,`5+3` | A range, either direction, or a project and the next few  |
+| `s:blocked` | Every project with that status, `st:` and `status:` too   |
+| `name`      | Exact or partial name, or a path, tab completion included |
+| `all`       | Every tracked project                                     |
+
+A temporary ID is the index of the latest output.
+
+When a partial name matches several projects, it's settled by
+`projects.conflict_resolution_preference`.
+
+## Configuration
+
+```sh
+t settings                    # everything (default deviations marked)
+t settings edit               # open in $EDITOR
+t sset list_limit 30          # rewrites that one line
+t list ll=5 rt=true           # override for one command only
+```
+
+A setting can be named in full, by its bare name, by a prefix, by the start of every word
+or by its initials, with the section shortening the same way: `display.list_limit`,
+`list_limit`, `list_lim`, `l_l`, `ll`, `d.ll`. Ambiguities are reported.
+
+| Setting                             | What it does                                                |
+|-------------------------------------|-------------------------------------------------------------|
+| `display.filter`                    | Filters every listing, e.g. `["-s:archive"]`                |
+| `display.columns`, `display.format` | Which columns, or a row layout of your own                  |
+| `display.relative_times`            | `2 days ago` instead of a timestamp                         |
+| `display.name_max_width`            | Shorten long names, `truncate` or `abbreviate`              |
+| `sorting.by`, `sorting.direction`   | `last_touched`, `last_used`, `name`, `status`, `id`, `path` |
+| `projects.ignore`, `.ignore_files`  | Directories and files that never count as your own work     |
+| `projects.auto_status`              | Status from how long ago a project was touched              |
+| `scan.detect_moves`                 | A moved project keeps its entry instead of looking deleted  |
+| `daemon.paths`, `daemon.interval`   | What the background scanner watches, and how often          |
+
+Notes can colour themselves: `t note 12 {red}broken{/} since friday`.
+
+## Development
+
+```sh
+make dev      # editable install plus ruff, basedpyright, pytest
+make check    # format, lint, types and tests (what CI runs)
+```
+
+## Disclosure
+
+LLMs were used to:
+
+- write the help section
+- write the man page
+- check for critical issues and annotation errors
+
+HOWEVER, the output was then manually reviewed and issues were fixed by a human.
+
+## License
+
+MIT [LICENSE](LICENSE).  
+By MattFor.