TJ3(1)

📦
version 3.8.1 · 5 versions
, in ubuntu resolute, ubuntu stonking

💖 TJ3(1) 💖

okay bestie, so this is tj3, the main character of the TaskJuggler universe (the manual calls it TaskJuggler, I call it the icon ✨)

🌸 NAME 🌸

tj3 — schedules tj3 projects and generates reports. yes that's it. that's the whole vibe. it schedules. it generates. it slays. 💅

✨ SYNOPSIS ✨

tj3 [options]

🦋 DESCRIPTION 🦋

So like, this is the main application, no cap. It reads in your project files, schedules the project, and generates the reports. That's the whole arc. Read ➡️ schedule ➡️ generate. main character energy fr fr 🫶

🎀 OPTIONS 🎀

okay this is the long part but every single one matters bestie, don't skip 🙈

  • --config <FILE> — use the YAML configuration file you specify, lowkey important
  • --silent — don't show program and progress information. quiet mode. shhh 🤫
  • --no-color — don't use ANSI control sequences to color the terminal output. Colors should only be used when spooling to an ANSI terminal, and if that detection fails, this option forces colors off. like a manual override 💅
  • --debug — enable Ruby debug mode (Ruby!! the engine!! 🔥)
  • --debuglevel N — verbosity of debug output, i.e. how much yapping
  • --debugmodules x,y,z — restrict debug output to a list of modules, so only the ones you name get to yap
  • --freeze — generate or update the booking file for the project. The file will have the same base name as the project file but has a -bookings.tji extension. cute lil sibling file 🧊
  • --freezedate <date> — use a different date than the current moment as the cut-off date for the booking file
  • --freezebytask — group the bookings in the booking file generated during a freeze by task instead of by resource. so you can sort it the other way, periodt
  • --check-time-sheet <tji-file> — check the given time sheet ✅
  • --check-status-sheet <tji-file> — check the given status sheet ✅
  • --warn-ts-deltas — turn on warnings for requested changes in time sheets
  • --check-syntax — only parse the input files and check the syntax. no scheduling, just vibes check 🌈
  • --no-reports — just schedule the project, but don't generate any reports
  • --list-reports <report ID regular expression> — list id, formats and file name of all the defined reports that have IDs that match the specified regular expression
  • --report <report ID> — only generate the report with the specified ID. This option can be used multiple times. stack them, bestie 📚
  • --reports <report ID regular expression> — only generate the reports that have IDs that match the specified regular expression. This option can be used multiple times.
  • -f, --force-reports — generate reports despite scheduling errors. bold. iconic. 🫡
  • --add-trace — append a current data set to all trace reports
  • --abort-on-warnings — abort program on warnings like we do on errors. warnings get treated like the full drama 💀
  • -o <directory>, --output-dir — directory the reports should go into
  • -c N — maximum number of CPU cores to use. let it cook 🔥
  • -h, --help — show this message
  • --version — show version info

💜 ENVIRONMENT 💜

  • TASKJUGGLER_DATA_PATH — override the path to the TaskJuggler data folder. The data folder contains the css, icons and scripts for TaskJuggler reports. so like, the whole aesthetic folder 🎨
  • TZ — the POSIX Time Zone environment variable.

Also!! listen: any environment variable may be used in a TaskJuggler file using the expression $(VAR_NAME). iykyk 🌟

🌈 EXAMPLES 🌈

tj3 tutorial.tjp

look at her go. absolute queen behavior 👑

Copyright © 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020

by Chris Schlaeger <cs@taskjuggler.org>

This program is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation.

For more info about TaskJuggler see http://www.taskjuggler.org

🍓 SEE ALSO 🍓

tj3client(1), tj3d(1), tj3man(1), tj3ss_receiver(1), tj3ss_sender(1), tj3ts_receiver(1), tj3ts_sender(1), tj3ts_summary(1), tj3webd(1)

The full TaskJuggler manual is available online at http://www.taskjuggler.org/tj3/manual/, or via the tj3man command. the whole friend group fr fr 🫶

and that's the page bestie!! this one's from TaskJuggler 3.8.1, dated January 2026, and it's the TJ3(1) manual — so if you ever need her again, she's right there. go schedule something iconic 💖✨🎀

📦 where this page comes from