puter/tools
KernelDeimos 202e7f06e2 test: cleanup and tweak batch test
One of the test cases has been rendered redundant so it has been
removed. Another test was changed to overwrite a file as it's expected
to already exist.
2025-01-14 09:42:20 -05:00
..
api-tester test: cleanup and tweak batch test 2025-01-14 09:42:20 -05:00
comment-parser Update copyright notice dates in license headers 2025-01-06 15:18:22 -08:00
comment-writer Update copyright notice dates in license headers 2025-01-06 15:18:22 -08:00
file-walker Update copyright notice dates in license headers 2025-01-06 15:18:22 -08:00
keygen Update copyright notice dates in license headers 2025-01-06 15:18:22 -08:00
license-headers Update copyright notice dates in license headers 2025-01-06 15:18:22 -08:00
migrations-test Update copyright notice dates in license headers 2025-01-06 15:18:22 -08:00
module-docgen Update copyright notice dates in license headers 2025-01-06 15:18:22 -08:00
token-count-accuracy Update copyright notice dates in license headers 2025-01-06 15:18:22 -08:00
.commit Move .commit to /tools 2024-07-09 15:58:55 -07:00
build_relay.sh dev: add build script for relay 2024-09-18 16:21:07 -04:00
build_v86.sh dev: update v86, switch twisp to epoxy-server with twisp feature 2024-10-07 22:04:41 -04:00
check-translations.js Update copyright notice dates in license headers 2025-01-06 15:18:22 -08:00
gen-release-notes.js dev: update release notes generator 2025-01-07 15:33:53 -05:00
l_checker_config.json chore: cleanup root directory 2024-07-09 04:18:55 -04:00
README.md doc: document tools directory (README.md) 2024-12-06 11:39:07 -05:00
run-selfhosted.js fix: missing changes to run-selfhosted.js 2025-01-13 09:11:39 -05:00

Tools Directory

This directory contains tools for developing and running puter. Each directory inside /tools is an npm workspace, so it can have its own package.json file and dependencies.

Scripts

run-selfhosted.js

This is the main script for running a local instance of Puter. It verifies the version of node.js you are running and attempts to explain any errors that come up if initiating boot fails.

Puter is booted with essential modules, and modules required for local file storage.

gen-release-notes.js

Generates release notes between a hard-coded pair of versions. These versions need to be modified manually in the script source before running.

check-translations.js

Checks for missing translations in src/gui/src/i18n/translations

Utilities

comment-writer

Generates comments in source files using generative AI via Puter's AI drivers.

To use this:

  • cd into the tools/comment-writer directory
  • Edit config.json and replace auth_token with your own
  • Run with a specified direcotry; for example: node main.js ../../src/backend/services

module-docgen

Document a module.

Libraries

comment-parser

This is a package used by the license-headers tool to process existing comments.

file-walker

This is used by license-headers and comment-writer to walk through source files.