Documentation

Company intelligence, working for you.

Answers for directors and staff using Pythagoras CIS to manage Torn company training, staff history, weekly reports, exports, and support keys.

What is Pythagoras CIS?

Pythagoras CIS is a Tampermonkey userscript designed for Torn company management. It provides a local workspace for managing the training ledger, FIFO train planner, staff and director history, daily report analytics, licensing, backups, and themed reports.

How do I install it?

Install a userscript manager such as Tampermonkey, or use Torn PDA’s userscript support. Then install the latest public build from the release link.

After installation, open Torn and use the Pythagoras CIS panel to configure your API key, company ID, theme, and support options.

What API key access does it need?

A Minimal API key is sufficient for basic functionality. A Full Access API key is required for advanced features.

The script only uses your Torn API key when you manually trigger a sync. It does not perform background polling or automated request chains.

If Remember locally is not enabled, the API key will not be stored when saving settings.

Where is my data stored?

All data — including ledger entries, staff history, analytics, settings, and license information — is stored locally in Tampermonkey storage, with a browser storage fallback.

No data is transmitted to any Pythagoras Project servers. Exports are created locally and only shared if you choose to do so.

How does the Training Ledger calculate costs?

The ledger starts with your base price per train and applies the configured discount rules:

  • Manual discount
  • Merit discount (default: 1% per merit, up to 10%, fully configurable)
  • Loyalty tiers such as 10:5%, 25:7%, 50:10% (fully customisable)
  • Optional global promotional discounts (e.g. 25% or 50%)

All totals update dynamically as you edit entries, including paid, unpaid, completed, pending, used trains, and remaining trains.

How does the Train Planner work?

The planner follows a FIFO (First In, First Out) approach for paid training entries. Paid users are prioritised up to the configured daily cap, after which remaining capacity is allocated to sponsored rotation users.

Daily training capacity is based on company stars (1–10), with an additional train available when the Trainer role is enabled in settings.

What does the Timeline track?

The timeline processes company news entries and classifies them into categories such as Hire, Application, Left, Fired, Director, Rating, Daily Reports, Training, Withdraw, Deposit, Wage, Funds, and Other.

These events are also used to build structured views of current and past staff and directors, where sufficient data is available.

How are weekly analytics calculated?

Daily report entries containing customer and income data are parsed into weekly summaries.

The system tracks week number, date range, customers, income, profit per customer, and comparisons against both the previous week and long-term averages.

What is the wage system?

The wage helper estimates staff wages based on MAN, INT, END, merit bonuses, addiction penalties, and inactivity penalties.

This is a configurable planning tool and does not reflect official Torn payroll values.

What do Supporter, Company Boost, and Ultimate unlock?

The free version includes all core features. Supporter unlocks premium functionality such as full data backups and additional tools. Company Boost focuses on advanced company analytics. Ultimate includes all features along with premium support.

Licences are available as 30-day or lifetime options, with a 7-day trial available for each tier.

Licensing is handled through my Discord server. First make sure you are verified there, then go to #bot-commands, talk to The Stig, and run /buylicense.

That Discord flow is the route for starting or buying the licence tier you need.

What benefits does each tier include?

Each tier is designed for different levels of company management, from basic tools to full operational insight and reporting.

Supporter

  • Full data export and import (ledger, staff history, analytics, settings, and licence backup)
  • Enhanced newsletter and reporting tools
  • Supporter badge for forum signatures

Company Boost

  • Advanced company analytics and monitoring tools
  • Improved visibility into staff performance and operational trends
  • Company-linked licensing

Ultimate

  • Includes all Supporter and Company Boost features
  • Best suited for full company management and long-term analytics
  • Includes premium support
Why is my key rejected?

Common causes include mismatched Torn user ID, incorrect company ID for boost licences, expired keys, or corrupted copy-paste input.

Use Settings → Import licence key and ensure the full key is entered correctly.

What can I export?

Supporter tier and above can export and import full datasets, including ledger, staff history, analytics, settings, and licence data.

The system can also generate themed HTML reports, newsletter-ready outputs, and forum-ready snippets.

Does popup mode persist?

Yes. Popup mode is remembered across Torn page navigation.

If your browser blocks popups, a fallback badge will appear allowing you to reopen the panel with a single click.

Can I change the colours and theme?

Yes. Settings include theme presets and colour controls for roles and contracts.

You can select presets such as MoDuL Dark or Blue & Gold, or use the theme builder to create a custom configuration.

The panel is not showing. What should I check?
  • Ensure the userscript is enabled in Tampermonkey or Torn PDA
  • Reload Torn after installation or updates
  • Check if the UI is minimised into the badge
  • Verify popup permissions if popup mode is enabled
The API sync failed. What should I check?
  • Ensure your API key is active and has the correct permissions
  • Verify the API key is entered correctly in settings
  • Confirm the company ID is correct
  • Retry if the Torn API is temporarily unavailable or rate limited
  • Use one sync action at a time (one action = one request)
How do I report a bug?

Use Settings → Report bug within the userscript.

This copies a diagnostic block including version, page URL, user ID, company ID, ledger count, timeline count, and timestamp.

Include this information when reporting issues to help speed up troubleshooting.

How do I contact support?

Use the Message me link in Settings.

If it is missing, install the latest version of the script or contact the maintainer for the current support link.