TKTS(1)

📦 version 3.0.2, in alpine 3.24

✨ tkts(1) — the time tracking & invoicing bestie ✨

okay so real talk, <pink>tkts</pink> is the manual page for a cli first ticketing/project management tool, and it's got little bits of crm functionality sprinkled in like glitter on a birthday cake 🎂✨ It's giving "I run my whole freelance life from the terminal" and honestly? iconic.

It lives in section 1 of the manual (User Commands, iykyk) 💅

🌈 SYNOPSIS 🌈

The whole vibe in one line, no cap:

tkts [NAMESPACE:COMMAND] [OPTIONS]

So you give it a namespace:command situation, you toss some options at it, and it slays. Periodt.

💖 DESCRIPTION 💖

tkts is a cli first ticketing/project management tool, with little bits of crm functionalities sprinkled in. That's the whole pitch bestie, and it's lowkey perfect.

🎀 Command Namespaces 🎀

These are the main character namespaces, the group chats your commands live in:

  • ticket — the default namespace for ticket operations. Like, if you don't specify anything, this is where you're at 🎟️
  • project — project management operations 📋
  • company — company record operations 🏢
  • client — client record operations 🤝
  • invoice — invoice generation and management 💸

⭐ COMMANDS ⭐

🎟️ Ticket Operations

  • create, close, reopen, info, log, edit, time, status, list — see tkts-ticket(1)

📋 Project Operations

  • project:create, project:edit, project:add-tkt, project:rm-tkt, project:status, project:complete, project:hold, project:reactivate, project:invoice, project:report, project:list — see tkts-project(1)

🏢 Company Operations

  • company:create, company:edit, company:list, company:info — see tkts-company(1)

🤝 Client Operations

  • client:create, client:edit, client:list, client:info — see tkts-client(1)

💸 Invoice Operations

🌸 CONFIGURATION 🌸

All the settings underneath live in ~/.config/tkts/tkts.conf, and here's the tea on each one 🫖:

  • editor — the text editor used for editing tickets and logs (default: $EDITOR) ✍️
  • mail — the mail command for sending notifications (default: mutt -s) 📧
  • rate — hourly rate for time calculations (default: 0.00) 💰
  • user — username for ticket ownership (default: $USER) 👤
  • company — user's company name (default: "Change Me") 🏷️ — and yes, you should actually change it, bestie 😭

🦋 FILES 🦋

  • ~/.config/tkts/tkts.conf — the configuration file
  • ~/.config/tkts/tkts.db — the SQLite database
  • ~/.config/tkts/invoice.tf — the invoice template

👑 AUTHOR 👑

Will Sinatra <tkts@lambdacreate.com> — thank you for your service 🫶

💜 SEE ALSO 💜

tkts-ticket(1), tkts-project(1), tkts-company(1), tkts-client(1), tkts-invoice(1) — go read the whole fam, fr fr 📚

ok that's the whole page, go forth and track some time ⏰💅

tkts 3.0 🌈 dropped February 2025, so if you're reading this, you're on the slay-era version. mwah, bye bestie 💖🎀🦋

📦 where this page comes from