Skip to main content

Keep track of things you learn each day

Project description

CLI tool for recording and tracking things you learn(TILs).


Install TIL

$ pip install til-cli

Then start adding things that you learn:

$ til new "How to parse yaml in Python"
Just use ruamel.yaml
pip install ruamel.yaml

Store your TILs wherever you want using TIL plugins:

  • YAML: Write to a yaml file
  • ...more to come...

Copy .til.toml.default to your home directory as .til.toml and add more plugins or change their configuration. As an example by default TIL uses YAML plugin to store entries in til.yaml file in your home directory, this is configurable.

Simon Willison's TIL Page was main inspiration to be able to create something similar with minimal extra effort.

Planned features:

  • Initial implementation
  • YAML plugin as POC
  • CI / CD for publishing to pypi with releases
  • some tests
  • Other tools to install
    • MacOS - brew
    • Debian/Ubuntu - apt (snap packages?)
  • More plugins
    • POST to endpoint
    • Twitter
    • Email?
  • tags support (e.g. Python, js, k8s, devops, science, etc.)
  • Search tils by
    • keyword
    • tags


Install Python 3.x

Requires Python >= 3.9.

Consider installing it either with brew or using a tool like pyenv

$ brew install python@3.9

Or download from

Install poetry

$ brew install poetry


$ pip3 install poetry

Create Env

$ poetry env use python3.9          # Setup env
$ poetry shell                      # Drop into Poetry env
$ poetry install                    # Install from pyproject.toml

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

til-0.2.0.tar.gz (3.9 kB view hashes)

Uploaded Source

Built Distribution

til-0.2.0-py3-none-any.whl (4.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page