@profoundlogic/coderflow-server 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (202) hide show
  1. package/LICENSE.txt +322 -0
  2. package/README.md +158 -0
  3. package/dist/LICENSE.txt +322 -0
  4. package/dist/README.md +158 -0
  5. package/dist/base-image/Dockerfile +184 -0
  6. package/dist/base-image/agent-wrapper.sh +143 -0
  7. package/dist/base-image/apply-local-state.sh +357 -0
  8. package/dist/base-image/coder-git-credential-helper +307 -0
  9. package/dist/base-image/entrypoint.sh +942 -0
  10. package/dist/base-image/ssh_config_template +41 -0
  11. package/dist/base-image/start-code-server.sh +76 -0
  12. package/dist/base-image/sync-repos.sh +170 -0
  13. package/dist/base-image/vscode-extensions.txt +10 -0
  14. package/dist/base-image/vscode-settings.json +41 -0
  15. package/dist/coder-server.js +2 -0
  16. package/dist/config/cli-models.json +45 -0
  17. package/dist/config/imported-skills.schema.json +83 -0
  18. package/dist/config/skill-catalog.json +18 -0
  19. package/dist/config/skill-catalog.schema.json +140 -0
  20. package/dist/config.js +1 -0
  21. package/dist/examples/oidc.json.example +11 -0
  22. package/dist/lib/agent-keepalive.js +1 -0
  23. package/dist/lib/api-keys.js +1 -0
  24. package/dist/lib/apiKeys.js +1 -0
  25. package/dist/lib/auto-judge.js +1 -0
  26. package/dist/lib/basic-auth.js +1 -0
  27. package/dist/lib/build-history.js +1 -0
  28. package/dist/lib/build-output-service.js +1 -0
  29. package/dist/lib/build-scheduler.js +1 -0
  30. package/dist/lib/build-service.js +1 -0
  31. package/dist/lib/claude-oauth-refresh.js +1 -0
  32. package/dist/lib/cli/build.js +1 -0
  33. package/dist/lib/cli/config-command.js +1 -0
  34. package/dist/lib/cli/config.js +1 -0
  35. package/dist/lib/cli/create-user.js +1 -0
  36. package/dist/lib/cli/init.js +1 -0
  37. package/dist/lib/cli/jira.js +1 -0
  38. package/dist/lib/cli/license.js +1 -0
  39. package/dist/lib/cli/server-manager.js +1 -0
  40. package/dist/lib/container-tokens.js +1 -0
  41. package/dist/lib/data-dir.js +1 -0
  42. package/dist/lib/deployment-history.js +1 -0
  43. package/dist/lib/deployment-service.js +1 -0
  44. package/dist/lib/docker-utils.js +1 -0
  45. package/dist/lib/email.js +1 -0
  46. package/dist/lib/emailTemplates.js +1 -0
  47. package/dist/lib/entitlement.js +1 -0
  48. package/dist/lib/fetch-utils.js +1 -0
  49. package/dist/lib/git-provider-service.js +1 -0
  50. package/dist/lib/git-provider-setup/assets/coderflow_github_app.png +0 -0
  51. package/dist/lib/git-provider-setup/github-setup-handler.js +1 -0
  52. package/dist/lib/git-provider-setup/index.js +1 -0
  53. package/dist/lib/git-provider-setup/setup-factory.js +1 -0
  54. package/dist/lib/git-provider-setup/setup-interface.js +1 -0
  55. package/dist/lib/git-providers/azure-devops-provider.js +1 -0
  56. package/dist/lib/git-providers/github-app-provider.js +1 -0
  57. package/dist/lib/git-providers/index.js +1 -0
  58. package/dist/lib/git-providers/provider-factory.js +1 -0
  59. package/dist/lib/git-providers/provider-interface.js +1 -0
  60. package/dist/lib/jira-client.js +1 -0
  61. package/dist/lib/logger.js +1 -0
  62. package/dist/lib/model-fetcher.js +1 -0
  63. package/dist/lib/notifications.js +1 -0
  64. package/dist/lib/oidc-auth.js +1 -0
  65. package/dist/lib/oidc-device-flow.js +1 -0
  66. package/dist/lib/passwordTokens.js +1 -0
  67. package/dist/lib/pin-cascade.js +1 -0
  68. package/dist/lib/provider-accounts.js +1 -0
  69. package/dist/lib/provider-oauth.js +1 -0
  70. package/dist/lib/provider-profile.js +1 -0
  71. package/dist/lib/provider-token-refresh.js +1 -0
  72. package/dist/lib/roles.js +1 -0
  73. package/dist/lib/secrets.js +1 -0
  74. package/dist/lib/state-capture.js +1 -0
  75. package/dist/lib/static-files.js +1 -0
  76. package/dist/lib/task-name-generator.js +1 -0
  77. package/dist/lib/users.js +1 -0
  78. package/dist/middleware/requireAuth.js +1 -0
  79. package/dist/middleware/requireInit.js +1 -0
  80. package/dist/middleware/requirePermission.js +1 -0
  81. package/dist/package-lock.json +4151 -0
  82. package/dist/package.json +50 -0
  83. package/dist/routes/apiKeys.js +1 -0
  84. package/dist/routes/auth-oidc.js +1 -0
  85. package/dist/routes/auth.js +1 -0
  86. package/dist/routes/build.js +1 -0
  87. package/dist/routes/containers.js +1 -0
  88. package/dist/routes/deploy-task.js +1 -0
  89. package/dist/routes/environment-management.js +1 -0
  90. package/dist/routes/environments.js +1 -0
  91. package/dist/routes/external-skills.js +1 -0
  92. package/dist/routes/git-credentials.js +1 -0
  93. package/dist/routes/git-provider-setup.js +1 -0
  94. package/dist/routes/health.js +1 -0
  95. package/dist/routes/jira.js +1 -0
  96. package/dist/routes/objective-management.js +1 -0
  97. package/dist/routes/password.js +1 -0
  98. package/dist/routes/prompt.js +1 -0
  99. package/dist/routes/provider-auth.js +1 -0
  100. package/dist/routes/qa.js +1 -0
  101. package/dist/routes/settings.js +1 -0
  102. package/dist/routes/skill-management.js +1 -0
  103. package/dist/routes/skills.js +1 -0
  104. package/dist/routes/tasks.js +2 -0
  105. package/dist/routes/templates.js +1 -0
  106. package/dist/routes/test-task.js +1 -0
  107. package/dist/routes/test.js +1 -0
  108. package/dist/routes/users.js +1 -0
  109. package/dist/routes/visualizations.js +1 -0
  110. package/dist/schemas/template-metadata.schema.json +178 -0
  111. package/dist/scripts/create-user.js +2 -0
  112. package/dist/shipped-skills/environment-instructions/SKILL.md +154 -0
  113. package/dist/shipped-skills/environment-templates/SKILL.md +282 -0
  114. package/dist/shipped-skills/objective-management/SKILL.md +238 -0
  115. package/dist/shipped-skills/skill-editor/SKILL.md +326 -0
  116. package/dist/start.js +2 -0
  117. package/dist/web-ui/public/activity-detail-modal.js +1 -0
  118. package/dist/web-ui/public/activity-feed.js +1 -0
  119. package/dist/web-ui/public/activity-formatters.js +1 -0
  120. package/dist/web-ui/public/agent-event-parser.js +1 -0
  121. package/dist/web-ui/public/app.js +1 -0
  122. package/dist/web-ui/public/approve-dialog.js +1 -0
  123. package/dist/web-ui/public/coderflow-logo-reversed.svg +46 -0
  124. package/dist/web-ui/public/coderflow-logo.svg +46 -0
  125. package/dist/web-ui/public/comments-widget.js +1 -0
  126. package/dist/web-ui/public/docs/.nojekyll +0 -0
  127. package/dist/web-ui/public/docs/README.md +26 -0
  128. package/dist/web-ui/public/docs/_sidebar.md +47 -0
  129. package/dist/web-ui/public/docs/admin/ai-providers.md +132 -0
  130. package/dist/web-ui/public/docs/admin/email-notifications.md +69 -0
  131. package/dist/web-ui/public/docs/admin/environments.md +215 -0
  132. package/dist/web-ui/public/docs/admin/git-providers.md +147 -0
  133. package/dist/web-ui/public/docs/admin/installation.md +313 -0
  134. package/dist/web-ui/public/docs/admin/skills.md +35 -0
  135. package/dist/web-ui/public/docs/admin/sso.md +241 -0
  136. package/dist/web-ui/public/docs/admin/users-and-roles.md +57 -0
  137. package/dist/web-ui/public/docs/code/cli.md +102 -0
  138. package/dist/web-ui/public/docs/code/files-and-editing.md +86 -0
  139. package/dist/web-ui/public/docs/code/terminal-access.md +110 -0
  140. package/dist/web-ui/public/docs/code/vscode-extension.md +58 -0
  141. package/dist/web-ui/public/docs/getting-started/core-concepts.md +129 -0
  142. package/dist/web-ui/public/docs/getting-started/overview.md +46 -0
  143. package/dist/web-ui/public/docs/index.html +151 -0
  144. package/dist/web-ui/public/docs/integrations/custom.md +58 -0
  145. package/dist/web-ui/public/docs/integrations/ibmi/overview.md +58 -0
  146. package/dist/web-ui/public/docs/integrations/overview.md +48 -0
  147. package/dist/web-ui/public/docs/objectives/qa-mode.md +90 -0
  148. package/dist/web-ui/public/docs/objectives/staged-tasks.md +60 -0
  149. package/dist/web-ui/public/docs/objectives/working-with-objectives.md +102 -0
  150. package/dist/web-ui/public/docs/tasks/approval-and-deployment.md +83 -0
  151. package/dist/web-ui/public/docs/tasks/creating-tasks.md +111 -0
  152. package/dist/web-ui/public/docs/tasks/judging.md +114 -0
  153. package/dist/web-ui/public/docs/tasks/providing-feedback.md +41 -0
  154. package/dist/web-ui/public/docs/tasks/task-groups.md +73 -0
  155. package/dist/web-ui/public/docs/tasks/winner-selection.md +75 -0
  156. package/dist/web-ui/public/docs/templates/batch-processing.md +152 -0
  157. package/dist/web-ui/public/docs/templates/task-templates.md +44 -0
  158. package/dist/web-ui/public/docs/templates/template-examples.md +93 -0
  159. package/dist/web-ui/public/docs/testing/profound-automated-testing.md +77 -0
  160. package/dist/web-ui/public/docs/testing/task-visualizations.md +42 -0
  161. package/dist/web-ui/public/docs/testing/testing-menu.md +118 -0
  162. package/dist/web-ui/public/environments.css +3942 -0
  163. package/dist/web-ui/public/environments.html +1791 -0
  164. package/dist/web-ui/public/environments.js +1 -0
  165. package/dist/web-ui/public/favicon-16.png +0 -0
  166. package/dist/web-ui/public/favicon-32.png +0 -0
  167. package/dist/web-ui/public/favicon.ico +0 -0
  168. package/dist/web-ui/public/feedback-widget.css +3133 -0
  169. package/dist/web-ui/public/feedback-widget.js +1 -0
  170. package/dist/web-ui/public/git-history.css +2663 -0
  171. package/dist/web-ui/public/git-history.html +272 -0
  172. package/dist/web-ui/public/git-history.js +1 -0
  173. package/dist/web-ui/public/git-status.js +1 -0
  174. package/dist/web-ui/public/index.html +1459 -0
  175. package/dist/web-ui/public/index.js +1 -0
  176. package/dist/web-ui/public/login.html +346 -0
  177. package/dist/web-ui/public/login.js +1 -0
  178. package/dist/web-ui/public/markdown-editor.js +1 -0
  179. package/dist/web-ui/public/markdown-file-editor.js +1 -0
  180. package/dist/web-ui/public/modal-maximize.js +1 -0
  181. package/dist/web-ui/public/notifications.js +1 -0
  182. package/dist/web-ui/public/server-health.js +1 -0
  183. package/dist/web-ui/public/settings.css +761 -0
  184. package/dist/web-ui/public/settings.html +1044 -0
  185. package/dist/web-ui/public/settings.js +1 -0
  186. package/dist/web-ui/public/setup-password.html +355 -0
  187. package/dist/web-ui/public/setup-password.js +1 -0
  188. package/dist/web-ui/public/skills.css +1949 -0
  189. package/dist/web-ui/public/skills.html +820 -0
  190. package/dist/web-ui/public/skills.js +1 -0
  191. package/dist/web-ui/public/sse-client.js +1 -0
  192. package/dist/web-ui/public/sse-shared-worker.js +1 -0
  193. package/dist/web-ui/public/styles.css +18614 -0
  194. package/dist/web-ui/public/task.html +1779 -0
  195. package/dist/web-ui/public/task.js +1 -0
  196. package/dist/web-ui/public/terminal.html +45 -0
  197. package/dist/web-ui/public/terminal.js +1 -0
  198. package/dist/web-ui/public/theme.js +1 -0
  199. package/dist/web-ui/public/users.html +298 -0
  200. package/dist/web-ui/public/users.js +1 -0
  201. package/dist/web-ui/public/variant-grouping.js +1 -0
  202. package/package.json +63 -0
package/LICENSE.txt ADDED
@@ -0,0 +1,322 @@
1
+ PROFOUND CODERFLOW SOFTWARE LICENSE AGREEMENT
2
+
3
+ This Software License Agreement (hereinafter "Agreement") is entered into between you ("Customer" or "you") and Profound Logic Software, Inc. ("Profound") and governs your access to and use of Profound CoderFlow and related software, tools, and services. By installing, accessing, or using CoderFlow, you agree to be bound by the terms of this Agreement. If you do not agree to these terms, you may not use CoderFlow.
4
+
5
+ 1. DEFINITIONS
6
+
7
+ 1.1 "Activation Date" shall mean the date on which you are provided with the License Key.
8
+
9
+ 1.2 "Agent" shall mean an autonomous software process within CoderFlow that executes engineering workflows, including but not limited to code generation, compilation, testing, validation, and deployment tasks.
10
+
11
+ 1.3 "Agent Execution" shall mean any instance in which an Agent performs work on your behalf, including but not limited to code analysis, code generation, build processes, test execution, validation cycles, and iterative fix-and-retest loops.
12
+
13
+ 1.4 "CoderFlow" shall mean Profound's agentic coding platform, comprising the CoderFlow Platform, CoderFlow Agents, CoderFlow CLI, and any related npm packages, tools, APIs, templates, and documentation provided by Profound for autonomous AI-assisted software development.
14
+
15
+ 1.5 "CoderFlow Agents" shall mean the autonomous AI agents provided as part of CoderFlow that execute engineering workflows, including code generation, building, testing, validation, refactoring, conversion, and documentation tasks.
16
+
17
+ 1.6 "CoderFlow CLI" shall mean the command-line interface tools and related npm packages provided by Profound for interacting with and orchestrating CoderFlow, including but not limited to any packages published under the @profound, @profoundjs, or @coderflow namespaces on npm or similar package registries and including but not limited to packages with "CoderFlow", "codermake", and "aitool" branding.
18
+
19
+ 1.7 "CoderFlow Components" shall mean, collectively, the CoderFlow Platform, CoderFlow Agents, CoderFlow CLI, and all related npm packages, libraries, APIs, templates, scripts, and tools provided by Profound as part of or for use with CoderFlow.
20
+
21
+ 1.8 "CoderFlow Platform" shall mean the containerized agentic execution platform provided by Profound, including the orchestration layer, agent runtime environment, execution containers, governance controls, audit logging, and administrative interfaces.
22
+
23
+ 1.9 "Confidential Information" shall mean any proprietary technologies, processes, software, trade secrets, data, know-how, technical specifications, documentation, pricing information, business strategies, and any other information disclosed by one party to the other that is marked as confidential or that reasonably should be understood to be confidential given the nature of the information and circumstances of disclosure. Confidential Information shall include, without limitation, all CoderFlow Components, License Keys, Agent configurations, workflow templates, and any technical documentation or specifications related to CoderFlow.
24
+
25
+ 1.10 "Customer Code" shall mean source code, object code, scripts, configuration files, and related materials that are owned by you or licensed to you by third parties, which you submit to or process through CoderFlow.
26
+
27
+ 1.11 "Customer Data" shall mean any data, information, or content that you submit to, process through, or store within CoderFlow, including but not limited to Customer Code, configuration data, credentials, environment variables, and any output generated by CoderFlow from your inputs.
28
+
29
+ 1.12 "Generated Output" shall mean any source code, documentation, test cases, configuration files, reports, or other materials created by CoderFlow Agents during Agent Execution based on your instructions or Customer Code.
30
+
31
+ 1.13 "Initial Term" shall mean:
32
+
33
+ (a) if the License Key is a trial license key, the thirty (30) day period of time starting on the Activation Date;
34
+
35
+ (b) if the License Key was priced on a subscription basis, the period of time between the Activation Date and the date on which your first payment following the Activation Date is due; or
36
+
37
+ (c) if the License Key is not a trial license key and was not priced on a subscription basis, the period of time between the Activation Date and the one (1) year anniversary of the Activation Date.
38
+
39
+ 1.14 "License Key" shall mean a license key provided to you by Profound which enables your use of CoderFlow. In the event you are provided multiple license keys by Profound, then each such license key shall be deemed to be a License Key which is governed by a separate instance of this Agreement.
40
+
41
+ 1.15 "LLM Provider" shall mean any third-party provider of large language model services that may be used by CoderFlow for AI capabilities, including but not limited to Anthropic (Claude), OpenAI, Google (Gemini), and any other providers supported by CoderFlow.
42
+
43
+ 1.16 "Partition" shall mean a single logical partition (LPAR) on an IBM i system, a single virtual machine, a single container environment, or a single physical or virtual server instance, as applicable to your deployment configuration.
44
+
45
+ 1.17 "Renewal Term" shall mean:
46
+
47
+ (a) if the License Key was priced on a subscription basis, the period of time between the last day of the then current Initial or Renewal Term, and the next date on which a payment is due following the end of the then current Initial or Renewal Term; or
48
+
49
+ (b) if the License Key was not priced on a subscription basis, the period of time between the last day of the then current Initial or Renewal Term, and the next anniversary of the Activation Date.
50
+
51
+ 1.18 "Term" shall mean the Initial Term and any Renewal Terms.
52
+
53
+ 1.19 "Third-Party Components" shall mean any third-party software, libraries, tools, or services that are incorporated into, bundled with, or required for the operation of CoderFlow, including but not limited to LLM Provider services, open-source libraries, and third-party APIs.
54
+
55
+ 2. LICENSE GRANT
56
+
57
+ 2.1 GRANT OF LICENSE. Subject to the terms and conditions of this Agreement, and conditioned upon your payment of all applicable fees, Profound hereby grants to you, during the Term, a non-exclusive, non-sublicensable, non-transferable license to:
58
+
59
+ (a) install the CoderFlow Components on computers and servers owned or controlled by you, in accordance with the deployment configuration specified in your order or license documentation;
60
+
61
+ (b) use the CoderFlow Platform to orchestrate and execute CoderFlow Agents for the purpose of software development, code conversion, refactoring, testing, documentation, and related engineering tasks;
62
+
63
+ (c) use the CoderFlow CLI and related npm packages to interact with and control CoderFlow in accordance with this Agreement;
64
+
65
+ (d) authorize your employees and authorized independent contractors working on your behalf to use CoderFlow, subject to the license restrictions set forth in Section 3; and
66
+
67
+ (e) use CoderFlow in combination with other Profound software products, including Profound.js, Profound AppDev, Profound API, and Profound AI, to the extent you hold valid licenses for such other Profound software.
68
+
69
+ 2.2 TRIAL LICENSE. If the License Key is a trial license key, then you are hereby authorized to, during the Term, use CoderFlow solely for the purpose of evaluating CoderFlow and deciding whether to obtain a commercial license key for CoderFlow from Profound. Trial licenses are limited to non-production use only and may have additional functional limitations as determined by Profound.
70
+
71
+ 2.3 GENERATED OUTPUT. Subject to your compliance with this Agreement and all applicable laws:
72
+
73
+ (a) Profound claims no ownership in Generated Output that is created by CoderFlow based on your Customer Code or your specific instructions;
74
+
75
+ (b) You acknowledge that Generated Output may incorporate patterns, structures, or techniques derived from CoderFlow's underlying algorithms and training, and such incorporation does not transfer any ownership interest in CoderFlow or its underlying technology to you;
76
+
77
+ (c) You are solely responsible for reviewing, testing, validating, and approving all Generated Output before deploying it to production environments or incorporating it into your systems; and
78
+
79
+ (d) Profound makes no representations or warranties regarding the accuracy, completeness, security, or fitness for any particular purpose of any Generated Output.
80
+
81
+ 2.4 CUSTOMER CODE AND DATA. You retain all right, title, and interest in and to your Customer Code and Customer Data. You grant to Profound a limited, non-exclusive license to access, process, and use Customer Code and Customer Data solely as necessary to provide CoderFlow services to you and to improve CoderFlow's functionality, provided that any use for improvement purposes shall be limited to anonymized, aggregated data that cannot be used to identify you or reconstruct your specific Customer Code.
82
+
83
+ 3. RESTRICTIONS
84
+
85
+ 3.1 GENERAL RESTRICTIONS. You may not, and agree that you will not attempt to, and will not assist or allow others to:
86
+
87
+ (a) circumvent a technological measure that effectively controls, or is intended to control, access to any or all of CoderFlow, including the source code of any aspect of CoderFlow;
88
+
89
+ (b) alter, remove, or obscure any proprietary legend, copyright, or trademark notice contained in or on CoderFlow;
90
+
91
+ (c) reverse engineer, reverse assemble, decompile, or disassemble CoderFlow or any CoderFlow Component;
92
+
93
+ (d) modify, translate, or create derivative works based on CoderFlow or any CoderFlow Component;
94
+
95
+ (e) share, distribute, sublicense, rent, lease, or lend CoderFlow or any License Key to any third party;
96
+
97
+ (f) take any action which is intended to, or would reasonably be expected to, interfere with the operation of CoderFlow, including any activities which would reasonably be expected to interfere with or degrade the operation of equipment used by Profound to operate CoderFlow or any related services;
98
+
99
+ (g) use CoderFlow to process, store, or transmit any material that infringes or misappropriates the intellectual property rights of any third party, or that is unlawful, defamatory, or otherwise objectionable;
100
+
101
+ (h) use CoderFlow, or any information derived from CoderFlow, for (i) creating products or services which are competitive with, or which could serve as a replacement for, CoderFlow; (ii) benchmarking or competitive analysis of CoderFlow; or (iii) any other purpose that is, or may be, to Profound's detriment or commercial disadvantage;
102
+
103
+ (i) attempt to gain unauthorized access to CoderFlow, other accounts, computer systems, or networks connected to CoderFlow;
104
+
105
+ (j) use CoderFlow to generate malicious code, malware, exploits, or any software designed to damage, disrupt, or gain unauthorized access to computer systems;
106
+
107
+ (k) remove, disable, or circumvent any security features, governance controls, or audit logging functionality within CoderFlow; or
108
+
109
+ (l) use CoderFlow in any manner that violates applicable laws, regulations, or third-party rights.
110
+
111
+ 3.2 LICENSE KEY RESTRICTIONS. You may not share or otherwise make the License Key available to any third party, and must treat the License Key as Confidential Information of Profound.
112
+
113
+ 3.3 PARTITION-BASED LICENSING. If the License Key is priced based on limiting the use of CoderFlow on a specific number of Partitions, then, unless you purchase additional license capacity from Profound, you may not use CoderFlow except on the number of Partitions specified in your license documentation.
114
+
115
+ 3.4 CONCURRENT USER LICENSING. If the License Key is priced based on CoderFlow being used concurrently by no more than a limited number of individuals on a Partition, then, unless you purchase additional license capacity from Profound, the number of individuals who you authorize or allow to use CoderFlow at any one time (including your employees and authorized independent contractors) may not exceed the number of concurrent users specified in your license documentation.
116
+
117
+ 3.5 NAMED USER LICENSING. If the License Key is priced based on CoderFlow being used by no more than a limited number of unique named users, then, unless you purchase additional license capacity from Profound, once the number of individuals you have allowed or authorized to use CoderFlow has reached the specified limit, you may not authorize or allow any additional individuals to use CoderFlow without first removing authorization from an existing user.
118
+
119
+ 3.6 AGENT EXECUTION LIMITS. If your license includes limits on Agent Executions, you agree to abide by such limits. Profound reserves the right to monitor Agent Execution usage and to suspend or throttle access to CoderFlow if you exceed your licensed limits.
120
+
121
+ 3.7 VIOLATION REPORTING. In the event you become aware of any violation or attempted violation of the provisions of this Section 3, you will immediately inform Profound of that violation and provide Profound such assistance as it may reasonably request to remediate any actual or potential damage caused by such actual or attempted violation.
122
+
123
+ 3.8 MATERIAL BREACH. You acknowledge that the license set forth in this Agreement is conditioned on your compliance with the requirements of this Section 3, and that any breach of the requirements of this Section 3 will be considered to be a material breach of this Agreement.
124
+
125
+ 4. INTELLECTUAL PROPERTY
126
+
127
+ 4.1 OWNERSHIP. You acknowledge and agree that CoderFlow, including all CoderFlow Components, and the intellectual property rights, moral rights, and goodwill therein and any derivative works thereof, is wholly owned by and shall remain the sole property of Profound. This Agreement does not convey to you any ownership interest in or to CoderFlow, but only a limited right of use revocable in accordance with the terms of this Agreement.
128
+
129
+ 4.2 TRADEMARKS. Profound has numerous trademarks and service marks (collectively, "Trademarks") including, without limitation, PROFOUND LOGIC, the Profound Logic Software logo, the CoderFlow logo, CODERFLOW, FUTURIZATION, PROFOUND APPDEV, PROFOUND API, PROFOUND AI, PROFOUND.JS, PROFOUND UI, and related marks. No right, license, or interest in or to Trademarks is granted to you under this Agreement.
130
+
131
+ 4.3 FEEDBACK. If you provide Profound with any suggestions, ideas, enhancement requests, feedback, recommendations, or other input regarding CoderFlow ("Feedback"), you hereby grant to Profound a perpetual, irrevocable, worldwide, royalty-free, fully paid-up, non-exclusive license to use, reproduce, modify, create derivative works from, distribute, and otherwise exploit such Feedback for any purpose without restriction or obligation to you.
132
+
133
+ 4.4 THIRD-PARTY COMPONENTS. CoderFlow may include or require Third-Party Components, which are subject to their own license terms. You agree to comply with all applicable third-party license terms. A list of Third-Party Components and their applicable licenses is available upon request or in the CoderFlow documentation.
134
+
135
+ 5. CONFIDENTIALITY
136
+
137
+ 5.1 CONFIDENTIAL INFORMATION. In the course of carrying out this Agreement, each party may be exposed to Confidential Information of the other party. Notwithstanding the foregoing, Confidential Information shall not include any information which (i) was publicly known or made generally available in the public domain prior to the time of disclosure; (ii) becomes publicly known or made generally available to the public through no fault of the receiving party; (iii) is in the receiving party's possession at the time of disclosure without confidentiality restrictions, as evidenced by written records; or (iv) is independently developed by the receiving party without use of the disclosing party's Confidential Information, as evidenced by written records.
138
+
139
+ 5.2 LIMITED USE. Each party agrees not to use any Confidential Information of the other party for any purpose except in accordance with this Agreement. Each party agrees not to disclose any Confidential Information of the other party to third parties, except to its employees and authorized independent contractors who have a need to know such information for purposes of this Agreement and who are bound by confidentiality obligations at least as protective as those contained herein.
140
+
141
+ 5.3 MAINTENANCE OF CONFIDENTIALITY. Each party shall take all commercially reasonable measures to protect the secrecy of and avoid unauthorized disclosure and unauthorized use of the Confidential Information of the other party. Each party shall reproduce any proprietary rights notices on any approved copies of Confidential Information in the same manner in which such notices were set forth in or on the original.
142
+
143
+ 5.4 COMPELLED DISCLOSURE. If either party is compelled by law, regulation, or court order to disclose Confidential Information of the other party, the compelled party shall, to the extent legally permitted, provide the other party with prompt written notice of such requirement so that the other party may seek a protective order or other appropriate remedy. The compelled party shall disclose only such Confidential Information as is legally required and shall use commercially reasonable efforts to obtain confidential treatment for any Confidential Information so disclosed.
144
+
145
+ 6. DATA PROCESSING AND SECURITY
146
+
147
+ 6.1 DATA PROCESSING. You acknowledge that CoderFlow may process Customer Code and Customer Data as necessary to provide the services contemplated by this Agreement. Such processing may include, without limitation:
148
+
149
+ (a) transmitting minimal code context to LLM Providers for the purpose of generating code suggestions, completions, and other AI-assisted outputs;
150
+
151
+ (b) executing builds, tests, and validation processes within isolated container environments;
152
+
153
+ (c) storing logs, audit trails, and execution records for governance and compliance purposes; and
154
+
155
+ (d) analyzing anonymized, aggregated usage data to improve CoderFlow functionality.
156
+
157
+ 6.2 LLM PROVIDER DATA HANDLING. You acknowledge and agree that:
158
+
159
+ (a) CoderFlow may transmit minimal code snippets and context to LLM Providers as necessary to provide AI-assisted functionality;
160
+
161
+ (b) Profound uses commercially reasonable efforts to minimize the data transmitted to LLM Providers and does not transmit full repositories, credentials, or bulk data to LLM Providers;
162
+
163
+ (c) LLM Providers are subject to their own terms of service and privacy policies, and Profound is not responsible for the data handling practices of LLM Providers; and
164
+
165
+ (d) You are responsible for ensuring that your use of CoderFlow, including any data transmitted to LLM Providers, complies with your own data protection policies and applicable laws.
166
+
167
+ 6.3 SECURITY MEASURES. Profound shall implement and maintain commercially reasonable administrative, technical, and physical security measures designed to protect Customer Data against unauthorized access, disclosure, alteration, or destruction. Such measures include, without limitation:
168
+
169
+ (a) isolated container execution with least-privilege access controls;
170
+
171
+ (b) encryption of data in transit and at rest;
172
+
173
+ (c) role-based access controls and authentication mechanisms;
174
+
175
+ (d) audit logging and monitoring of system access and activities; and
176
+
177
+ (e) regular security assessments and vulnerability testing.
178
+
179
+ 6.4 CUSTOMER RESPONSIBILITIES. You are solely responsible for:
180
+
181
+ (a) maintaining the security of your own systems, networks, and credentials;
182
+
183
+ (b) ensuring that all users authorized to access CoderFlow comply with applicable security policies;
184
+
185
+ (c) promptly notifying Profound of any suspected security incidents or unauthorized access;
186
+
187
+ (d) backing up Customer Code and Customer Data; and
188
+
189
+ (e) reviewing and approving all Generated Output before deployment to production environments.
190
+
191
+ 7. LIMITED WARRANTY; WARRANTY DISCLAIMER; LIMITATION OF LIABILITY
192
+
193
+ 7.1 LIMITED WARRANTY. Each party warrants that it is duly organized and is duly authorized to execute and deliver this Agreement and to perform its respective obligations hereunder.
194
+
195
+ 7.2 WARRANTY DISCLAIMER. EXCEPT FOR THE LIMITED WARRANTY IN SECTION 7.1, CODERFLOW AND ALL CODERFLOW COMPONENTS ARE PROVIDED "AS-IS" AND PROFOUND MAKES NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH RESPECT TO CODERFLOW. PROFOUND EXPRESSLY DISCLAIMS THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND INFORMATIONAL CONTENT. THERE IS NO WARRANTY THAT THE OPERATION OF CODERFLOW WILL BE UNINTERRUPTED, ERROR-FREE, OR VIRUS-FREE, OR THAT CODERFLOW WILL MEET ANY PARTICULAR CRITERIA OF PERFORMANCE OR QUALITY. YOU ASSUME THE ENTIRE RISK OF SELECTION, INSTALLATION, AND USE OF CODERFLOW.
196
+
197
+ 7.3 AI-SPECIFIC DISCLAIMERS. WITHOUT LIMITING THE GENERALITY OF SECTION 7.2, YOU ACKNOWLEDGE AND AGREE THAT:
198
+
199
+ (a) CODERFLOW USES ARTIFICIAL INTELLIGENCE AND MACHINE LEARNING TECHNOLOGIES THAT MAY PRODUCE INACCURATE, INCOMPLETE, OR UNEXPECTED RESULTS;
200
+
201
+ (b) GENERATED OUTPUT MAY CONTAIN ERRORS, BUGS, SECURITY VULNERABILITIES, OR OTHER DEFECTS;
202
+
203
+ (c) GENERATED OUTPUT IS NOT A SUBSTITUTE FOR PROFESSIONAL JUDGMENT, CODE REVIEW, TESTING, AND VALIDATION BY QUALIFIED PERSONNEL;
204
+
205
+ (d) PROFOUND DOES NOT GUARANTEE THAT GENERATED OUTPUT WILL BE FREE OF INTELLECTUAL PROPERTY INFRINGEMENT OR THAT IT WILL BE SUITABLE FOR ANY PARTICULAR PURPOSE;
206
+
207
+ (e) THE PERFORMANCE AND CAPABILITIES OF LLM PROVIDERS MAY CHANGE WITHOUT NOTICE, WHICH MAY AFFECT CODERFLOW FUNCTIONALITY; AND
208
+
209
+ (f) YOU ARE SOLELY RESPONSIBLE FOR ALL DECISIONS REGARDING THE USE, DEPLOYMENT, OR INCORPORATION OF GENERATED OUTPUT INTO YOUR SYSTEMS OR PRODUCTS.
210
+
211
+ 7.4 LIMITATION OF LIABILITY. IN NO EVENT WILL PROFOUND BE LIABLE UNDER, OR IN CONNECTION WITH, THIS AGREEMENT OR ITS SUBJECT MATTER, UNDER ANY LEGAL OR EQUITABLE THEORY, INCLUDING BREACH OF CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY, OR OTHERWISE, FOR ANY:
212
+
213
+ (a) INCREASED COSTS, DIMINUTION IN VALUE, OR LOST BUSINESS, PRODUCTION, REVENUES, OR PROFITS;
214
+
215
+ (b) LOSS OF GOODWILL OR REPUTATION;
216
+
217
+ (c) USE, INABILITY TO USE, LOSS, INTERRUPTION, DELAY, OR RECOVERY OF CODERFLOW OR ANY CODERFLOW COMPONENT;
218
+
219
+ (d) LOSS, DAMAGE, CORRUPTION, OR RECOVERY OF DATA, OR BREACH OF DATA OR SYSTEM SECURITY;
220
+
221
+ (e) COST OF REPLACEMENT GOODS OR SERVICES;
222
+
223
+ (f) DAMAGES ARISING FROM OR RELATED TO GENERATED OUTPUT, INCLUDING DAMAGES CAUSED BY ERRORS, BUGS, SECURITY VULNERABILITIES, OR INTELLECTUAL PROPERTY INFRINGEMENT IN GENERATED OUTPUT;
224
+
225
+ (g) DAMAGES ARISING FROM OR RELATED TO THE ACTS OR OMISSIONS OF LLM PROVIDERS OR OTHER THIRD-PARTY SERVICE PROVIDERS; OR
226
+
227
+ (h) CONSEQUENTIAL, INCIDENTAL, INDIRECT, EXEMPLARY, SPECIAL, ENHANCED, OR PUNITIVE DAMAGES,
228
+
229
+ IN EACH CASE REGARDLESS OF WHETHER PROFOUND WAS ADVISED OF THE POSSIBILITY OF SUCH LOSSES OR DAMAGES OR SUCH LOSSES OR DAMAGES WERE OTHERWISE FORESEEABLE, AND NOTWITHSTANDING THE FAILURE OF ANY AGREED OR OTHER REMEDY OF ITS ESSENTIAL PURPOSE.
230
+
231
+ 7.5 CAP ON LIABILITY. IN NO EVENT WILL THE COLLECTIVE AGGREGATE LIABILITY OF PROFOUND ARISING OUT OF OR RELATED TO THIS AGREEMENT, WHETHER ARISING UNDER OR RELATED TO BREACH OF CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY, OR ANY OTHER LEGAL OR EQUITABLE THEORY, EXCEED THE TOTAL AMOUNTS PAID TO PROFOUND UNDER THIS AGREEMENT IN THE TWELVE (12) MONTHS PRECEDING THE EVENT GIVING RISE TO THE CLAIM, OR ONE HUNDRED DOLLARS ($100), WHICHEVER IS GREATER. THE FOREGOING LIMITATIONS APPLY EVEN IF ANY REMEDY FAILS OF ITS ESSENTIAL PURPOSE.
232
+
233
+ 8. INDEMNIFICATION
234
+
235
+ 8.1 INDEMNIFICATION BY CUSTOMER. You agree to indemnify, defend, and hold harmless Profound and its officers, directors, employees, agents, successors, and assigns from and against any and all claims, damages, losses, liabilities, costs, and expenses (including reasonable attorneys' fees) arising out of or related to:
236
+
237
+ (a) your use of CoderFlow in violation of this Agreement;
238
+
239
+ (b) your Customer Code or Customer Data, including any claims that Customer Code or Customer Data infringes or misappropriates the intellectual property rights of any third party;
240
+
241
+ (c) your use, deployment, or distribution of Generated Output;
242
+
243
+ (d) your violation of any applicable law, regulation, or third-party right; or
244
+
245
+ (e) any dispute between you and any third party arising from your use of CoderFlow.
246
+
247
+ 9. TERM AND TERMINATION
248
+
249
+ 9.1 TERM. The term of this Agreement shall commence upon the date and time that you install any CoderFlow Component or receive a License Key, whichever occurs first.
250
+
251
+ 9.2 AUTOMATIC RENEWAL. This Agreement will automatically expire on the first business day following the last day of the Term without requiring any further action by the parties. At the conclusion of the Initial Term and at the conclusion of each Renewal Term, this Agreement will automatically renew for an additional Renewal Term unless:
252
+
253
+ (a) this Agreement is terminated as set forth herein;
254
+
255
+ (b) you provide Profound with written notice that you do not wish for this Agreement to renew at least thirty (30) days prior to the end of the then current Term;
256
+
257
+ (c) if the License Key is priced on a subscription basis, you have not paid all amounts then due to Profound by the end of the then current Term; or
258
+
259
+ (d) the License Key is a trial license key (in which case there shall be no Renewal Terms, and the Term will expire on the conclusion of the Initial Term).
260
+
261
+ 9.3 TERMINATION FOR CAUSE. This Agreement may be terminated as follows:
262
+
263
+ (a) Profound may terminate this Agreement immediately and without notice upon breach of any material provision of this Agreement by you;
264
+
265
+ (b) Either party may terminate this Agreement upon thirty (30) days written notice if the other party commits a material breach of this Agreement and fails to cure such breach within such thirty (30) day period; or
266
+
267
+ (c) The parties may jointly terminate this Agreement by mutual written agreement.
268
+
269
+ 9.4 TERMINATION FOR CONVENIENCE. Profound may terminate this Agreement for convenience upon ninety (90) days written notice to you, in which case Profound shall refund to you a pro-rata portion of any prepaid fees for the period following the effective date of termination.
270
+
271
+ 9.5 EFFECT OF TERMINATION. Upon termination or expiration of this Agreement:
272
+
273
+ (a) All licenses granted hereunder shall immediately terminate;
274
+
275
+ (b) CoderFlow may be deactivated and rendered inoperable, without prior warning to you;
276
+
277
+ (c) You shall immediately cease all use of CoderFlow and all CoderFlow Components;
278
+
279
+ (d) You shall permanently delete any and all copies of CoderFlow Components, including any License Keys, on all computers and computer networks owned or controlled by you;
280
+
281
+ (e) Upon Profound's request, you shall certify in writing that you have complied with the foregoing obligations; and
282
+
283
+ (f) Sections 1, 3, 4, 5, 7, 8, 9.5, and 10 shall survive termination or expiration of this Agreement.
284
+
285
+ 10. MISCELLANEOUS
286
+
287
+ 10.1 TRANSFERABILITY. You may not assign or otherwise transfer any of your rights or delegate or otherwise transfer any of your obligations under this Agreement without Profound's prior written consent. Notwithstanding the foregoing, you may assign this Agreement as part of a corporate reorganization, consolidation, merger, or sale of substantially all assets or all stock of your company, provided that you shall provide written notice of such assignment to Profound within thirty (30) days of such assignment. Profound may assign or otherwise transfer any of its rights or delegate or otherwise transfer any of its obligations under this Agreement without restriction. This Agreement shall inure to the benefit of and be binding upon the successors and permitted assigns of the parties.
288
+
289
+ 10.2 NOTICES. All notices to Profound under this Agreement must be in writing to Profound Logic Software, Inc., 1133 Camelback St. #12559, Newport Beach, CA 92658, through (i) personal service, (ii) via certified mail, return receipt requested, or (iii) via nationally recognized overnight courier. Notices to you may be sent to the email address or physical address associated with your account or License Key.
290
+
291
+ 10.3 GOVERNING LAW. This Agreement shall be construed and governed in accordance with the substantive laws of the State of Ohio, without regard to its conflict of laws principles. Any claim related to this Agreement or CoderFlow shall be brought in a court of competent jurisdiction in Hamilton County, Ohio. You hereby waive any defense that you are not subject to the jurisdiction of such courts, that any such action is brought in an inconvenient forum, or that venue of the action is improper.
292
+
293
+ 10.4 AUDIT. From time to time, Profound may hire a disinterested third party to audit and inspect your books, records, computers, and computer networks for compliance with this Agreement. All such audits shall be during normal business hours and on dates mutually agreed upon with reasonable advance notice, and you agree to cooperate in such audits and inspections. If any audit reveals that you have exceeded the scope of your license, you shall promptly pay to Profound the applicable fees for such excess usage, plus interest at the rate of one and one-half percent (1.5%) per month from the date such fees were due.
294
+
295
+ 10.5 UNENFORCEABILITY. It is intended that this Agreement shall not violate any applicable law. If, at any time or for any reason, any provision of this Agreement becomes unenforceable or invalid, such provision shall be amended to bring it into legal compliance and to preserve to the maximum extent possible the intent of the parties, and the remaining provisions shall remain unaffected and continue with the same effect as if such unenforceable or invalid provision had not been inserted herein.
296
+
297
+ 10.6 NO WAIVER. Failure of either party to exercise its rights under this Agreement shall not be construed as a waiver of that party's rights, including without limitation the right to seek remedies arising from past, present, or future breach by the other party.
298
+
299
+ 10.7 TAXES. You are responsible for any applicable sales, use, excise, value-added, or other similar taxes, levies, or duties payable with respect to your license of CoderFlow assessable by any local, state, provincial, federal, or foreign jurisdiction. Unless expressly specified otherwise, all fees exclude such taxes, levies, and duties. Profound is responsible only for taxes based upon Profound's net income, assets, payroll, property, and employees.
300
+
301
+ 10.8 FORCE MAJEURE. Neither party shall be liable for any failure or delay in performing its obligations under this Agreement (except for payment obligations) where such failure or delay results from causes beyond the reasonable control of such party, including but not limited to acts of God, natural disasters, war, terrorism, riots, embargoes, acts of civil or military authorities, fire, floods, epidemics, pandemics, strikes, or failures or degradation of third-party telecommunications or power supply.
302
+
303
+ 10.9 INDEPENDENT CONTRACTORS. The relationship between the parties is that of independent contractors. Nothing in this Agreement shall be construed to create a partnership, joint venture, agency, or employment relationship between the parties.
304
+
305
+ 10.10 HEADINGS. The headings and captions in this Agreement are for convenience purposes only and shall not be used to construe the terms of this Agreement.
306
+
307
+ 10.11 EXPORT. You shall not export or re-export directly or indirectly (including by remote access) any part of CoderFlow outside of the jurisdiction in which you obtained it without the appropriate United States or foreign government licenses and in compliance with all applicable export control laws and regulations.
308
+
309
+ 10.12 U.S. GOVERNMENT RIGHTS. If you are a U.S. Government agency or contractor, CoderFlow is provided as "Commercial Computer Software" and "Commercial Computer Software Documentation" as defined in 48 C.F.R. 2.101, and the rights of the U.S. Government are as set forth in 48 C.F.R. 12.212 or 48 C.F.R. 227.7202, as applicable.
310
+
311
+ 10.13 ENTIRE AGREEMENT. This Agreement contains the entire understanding between the parties with respect to the matters contained herein. This Agreement supersedes all prior agreements between the parties, whether oral or written, express or implied, as to the matters contained herein. No waiver, consent, modification, amendment, or change of the terms of this Agreement shall be binding unless in writing and signed by both parties.
312
+
313
+ 10.14 COUNTERPARTS. This Agreement may be executed in counterparts, each of which shall be deemed an original and all of which together shall constitute one and the same instrument. Electronic signatures shall be deemed valid and binding.
314
+
315
+
316
+ BY INSTALLING, ACCESSING, OR USING CODERFLOW, YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT, UNDERSTAND IT, AND AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS.
317
+
318
+
319
+ Profound Logic Software, Inc.
320
+ 1133 Camelback St. #12559
321
+ Newport Beach, CA 92658
322
+ www.profoundlogic.com
package/README.md ADDED
@@ -0,0 +1,158 @@
1
+ # CoderFlow Server
2
+
3
+ CoderFlow is an enterprise platform that runs autonomous engineering agents inside your infrastructure. Instead of merely suggesting code, agents compile, test, validate, and fix legacy systems end-to-end — delivering verified, ready-to-commit results and 5–10x productivity gains.
4
+
5
+ CoderFlow:
6
+
7
+ - Submits coding tasks to AI agents (Claude, Codex, Gemini) running in isolated Docker containers
8
+ - Lets agents execute code, compile, test, and validate changes automatically
9
+ - Supports both headless execution (submit once, review results later) and interactive sessions (work within containers for guided work)
10
+ - Manages multi-repository workspaces with build pipelines and test suites
11
+ - Allows developers to review, iterate, and approve changes before committing
12
+
13
+ ## Installation
14
+
15
+ ### Prerequisites
16
+
17
+ A Linux server with the following installed:
18
+
19
+ - **Docker** — [Install Docker Engine](https://docs.docker.com/engine/install/)
20
+ - **Git** — Available via your distribution's package manager
21
+
22
+ Optionally, if you'd like the server to listen on a port below 1024 (such as 443 or 80):
23
+
24
+ - **On Ubuntu and Debian-based distros** - Install [authbind](https://manpages.ubuntu.com/manpages/noble/man1/authbind.1.html) via APT package manager.
25
+ - **Other distros** - See your distro's documentation for enabling non-root users to bind network services to privileged ports
26
+
27
+ ### Root Permissions
28
+
29
+ > [!IMPORTANT]
30
+ > Only a few parts of the installation process require root permissions.
31
+ > Do not use root permissions (i.e. `sudo` or `su`) except where specifically instructed.
32
+ > The server installs and runs as a non-root user.
33
+
34
+ ### Create a Dedicated Linux User For Each Installation
35
+
36
+ Each installation of CoderFlow server should run under a unique and dedicated user account, rather than your personal account or root. This provides better security isolation and makes it easier to manage the service.
37
+
38
+ Create a dedicated user (we suggest `coder`, but any name works):
39
+
40
+ ```bash
41
+ # Create the user with a home directory
42
+ sudo useradd -m -s /bin/bash coder
43
+
44
+ # Set a password (optional, if you need interactive login)
45
+ sudo passwd coder
46
+
47
+ # Add the user to the docker group so it can manage containers
48
+ sudo usermod -aG docker coder
49
+ ```
50
+
51
+ If `coder` conflicts with an existing user on your system, choose a different name — the server works the same regardless of the username.
52
+
53
+ ### Optional: If Using Server Listen Port Below 1024
54
+
55
+ If you'd like to use a server listen port below 1024 (e.g. 443), configure `authbind` to allow the dedicated CoderFlow user to use the port:
56
+
57
+ For example, for port 443:
58
+
59
+ ```bash
60
+ sudo touch /etc/authbind/byport/443
61
+ sudo chown coder /etc/authbind/byport/443
62
+ sudo chmod 500 /etc/authbind/byport/443
63
+ ```
64
+
65
+ ### Switch to Dedicated CoderFlow User
66
+
67
+ Switch to the dedicated user before proceeding with installation:
68
+
69
+ ```bash
70
+ sudo su - coder
71
+ ```
72
+
73
+ ### Install Node.js via NVS
74
+
75
+ Use the [installation guide](https://github.com/jasongin/nvs?tab=readme-ov-file#mac-linux) to install Node Version Switcher (NVS) in the dedicated user's home directory. This allows each CoderFlow installation/user to use a separate version of Node.js. If you prefer, you can use `nvm` instead, but NVS will be used in this documentation.
76
+
77
+ After installing NVS, exit and restart your shell and then install Node 24:
78
+
79
+ ```bash
80
+ nvs add node/24
81
+ nvs use node/24
82
+ nvs link node/24
83
+ ```
84
+
85
+ ### Setup
86
+
87
+ #### Install the Server
88
+
89
+ ```bash
90
+ npm install -g @profoundlogic/coderflow-server
91
+ ```
92
+
93
+ #### Create a Setup Repository
94
+
95
+ The setup repository contains your environments, task templates, and configuration.
96
+
97
+ If your organization already has a setup repository, clone it:
98
+
99
+ ```bash
100
+ git clone https://github.com/your-org/mycompany-coder-setup.git
101
+ ```
102
+
103
+ Otherwise, create a new one:
104
+
105
+ ```bash
106
+ coder-server init mycompany-coder-setup
107
+ ```
108
+
109
+ This creates a `mycompany-coder-setup` directory with the required structure and initializes it as a git repository.
110
+
111
+ #### Install License
112
+
113
+ ```bash
114
+ coder-server license set <your-license-key> --setup-path=mycompany-coder-setup
115
+ ```
116
+
117
+ #### Create Admin User
118
+
119
+ ```bash
120
+ coder-server create-user --username=admin --email=admin@example.com --name="Admin User" --role=admin
121
+ ```
122
+
123
+ You'll be prompted to set a password.
124
+
125
+ #### Optional: Configure Server Listen Port and SSL
126
+
127
+ By default the server listens on port 3000. To configure an alternate port (e.g. 443):
128
+
129
+ ```bash
130
+ coder-server config set server_port 443
131
+ ```
132
+
133
+ To configure a certificate for SSL:
134
+
135
+ > [!INFO]
136
+ > Certificate and key files must be in PEM format.
137
+ > Concatenate certificate, intermediate, and root into a single file, in that order.
138
+ > File paths can be given as absolute or relative.
139
+ > Files must be readable by the dedicated CoderFlow user.
140
+
141
+ ```bash
142
+ coder-server config set ssl_cert_path mycert.pem
143
+ coder-server config set ssl_key_path mykey.pem
144
+ ```
145
+
146
+ #### Start the Server
147
+
148
+ ```bash
149
+ coder-server start
150
+ ```
151
+
152
+ If using a listen port below 1024 (e.g. 443, 80) and using `authbind` to allow that, the server must be started like this instead:
153
+
154
+ ```bash
155
+ authbind --deep coder-server start
156
+ ```
157
+
158
+ Once running, connect to the server's online documentation to continue with the installation (e.g., http://myserver:3000/docs/#/admin/installation?id=start-the-server).