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 cloud-backed 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 release from GreasyFork.

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.

The only local profile fields are API key, user ID, username, and company ID. Company records, analytics, staff history, planner data, settings, stock history, and licence status live in the Pythagoras backend.

Where is my data stored?

Company data is stored in a PostgreSQL-backed cloud workspace keyed by company ID. Every company-owned row includes its company ID, and server-side access checks decide which Torn user can open that workspace.

Free users can continue syncing and saving data, but Free visibility is limited to the last 7 days. Older saved data remains in the workspace and becomes visible if the account upgrades.

The script does not store business data, licence state, analytics, planner rows, staff history, stock history, or persistent UI state in browser storage.

Is there a standalone web dashboard?

Yes. Open the CIS web dashboard to view company information, reports, Staff history, and entitlement-aware Employee Efficiency graphs outside Torn.

Dashboard sign-in uses a Torn API key with company access. The server verifies it for each request and never writes it to the CIS database. The browser retains the key only in session storage until logout or the browser session ends.

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 core operation and cloud saving with 7-day visibility. Supporter, Company Boost, and Ultimate increase visible history and unlock server-enforced feature flags.

Licences are time-limited only: 1 month, 3 months, 6 months, or 12 months. Lifetime licences are not available.

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

  • View the last 90 days of saved company history
  • Basic reports, exports, imports, and graph tools
  • Enhanced newsletter and reporting tools
  • Supporter badge for forum signatures

Company Boost

  • View the last 365 days of saved company history
  • Archive access, advanced planner, stock, wage, role, report, and graph tools
  • Company-linked licensing

Ultimate

  • View all available saved company history
  • 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, an inactive server-side plan, 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 datasets according to the active entitlement. Free users can still save data, but only the last 7 days are visible until they upgrade.

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.