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:

  • <input type="checkbox" checked="" disabled="" /> Initial implementation
  • <input type="checkbox" checked="" disabled="" /> YAML plugin as POC
  • <input type="checkbox" disabled="" /> CI / CD for publishing to pypi with releases
  • <input type="checkbox" disabled="" /> some tests
  • <input type="checkbox" disabled="" /> Other tools to install
    • <input type="checkbox" disabled="" /> MacOS - brew
      • <input type="checkbox" disabled="" /> Debian/Ubuntu - apt (snap packages?)
  • <input type="checkbox" disabled="" /> More plugins
    • <input type="checkbox" disabled="" /> POST to endpoint
      • <input type="checkbox" disabled="" /> Twitter
      • <input type="checkbox" disabled="" /> Email?
  • <input type="checkbox" disabled="" /> tags support (e.g. Python, js, k8s, devops, science, etc.)
  • <input type="checkbox" disabled="" /> Search tils by
    • <input type="checkbox" disabled="" /> keyword
      • <input type="checkbox" disabled="" /> 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.

Files for til, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size til-0.2.0-py3-none-any.whl (4.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size til-0.2.0.tar.gz (3.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page