ultimatehuman 0.0.0-stage → 0.1.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 (30) hide show
  1. package/LICENSE +224 -0
  2. package/LICENSING.md +63 -0
  3. package/NOTICE +8 -0
  4. package/README.md +174 -2
  5. package/THIRD_PARTY_NOTICES.txt +436 -0
  6. package/dist/cli.mjs +33733 -0
  7. package/dist/dashboard/assets/ConversationWorkspace-6m6xkkC1.js +16 -0
  8. package/dist/dashboard/assets/ConversationWorkspace-De5tnYl0.css +1 -0
  9. package/dist/dashboard/assets/data-provider-CZ2WwK6_.js +1 -0
  10. package/dist/dashboard/assets/fmt-BRV4RZz4.js +12 -0
  11. package/dist/dashboard/assets/index-CIpIMh38.js +1 -0
  12. package/dist/dashboard/assets/index-pC0URNNS.js +2 -0
  13. package/dist/dashboard/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2 +0 -0
  14. package/dist/dashboard/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2 +0 -0
  15. package/dist/dashboard/assets/inter-greek-ext-wght-normal-DlzME5K_.woff2 +0 -0
  16. package/dist/dashboard/assets/inter-greek-wght-normal-CkhJZR-_.woff2 +0 -0
  17. package/dist/dashboard/assets/inter-latin-ext-wght-normal-DO1Apj_S.woff2 +0 -0
  18. package/dist/dashboard/assets/inter-latin-wght-normal-Dx4kXJAl.woff2 +0 -0
  19. package/dist/dashboard/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2 +0 -0
  20. package/dist/dashboard/assets/jetbrains-mono-cyrillic-wght-normal-D73BlboJ.woff2 +0 -0
  21. package/dist/dashboard/assets/jetbrains-mono-greek-wght-normal-Bw9x6K1M.woff2 +0 -0
  22. package/dist/dashboard/assets/jetbrains-mono-latin-ext-wght-normal-DBQx-q_a.woff2 +0 -0
  23. package/dist/dashboard/assets/jetbrains-mono-latin-wght-normal-B9CIFXIH.woff2 +0 -0
  24. package/dist/dashboard/assets/jetbrains-mono-vietnamese-wght-normal-Bt-aOZkq.woff2 +0 -0
  25. package/dist/dashboard/assets/page-CYCU6xk1.js +3 -0
  26. package/dist/dashboard/assets/render-card-BRSD9J_M.css +1 -0
  27. package/dist/dashboard/assets/render-card-C8_wQGAe.js +1 -0
  28. package/dist/dashboard/favicon.svg +5 -0
  29. package/dist/dashboard/index.html +14 -0
  30. package/package.json +45 -4
package/LICENSE ADDED
@@ -0,0 +1,224 @@
1
+ # ultimatehuman Community License 1.0
2
+
3
+ Copyright (c) 2026 Vincent Wargnier
4
+
5
+ This license consists of the additional small-business permission in Part A
6
+ and the unchanged PolyForm Noncommercial License 1.0.0 in Part B. This is a
7
+ custom combined license, not the standard PolyForm Noncommercial or PolyForm
8
+ Small Business license. The licensor is Vincent Wargnier.
9
+
10
+ ## Part A — Additional small-business permission
11
+
12
+ ### 1. Additional permitted purpose
13
+
14
+ In addition to every purpose permitted by Part B, the licensor permits you
15
+ to use and modify the software for your company's internal business
16
+ operations and the development and operation of its own products and
17
+ services while your company has fewer than two employees. This permission
18
+ is available without a fee or a separate application.
19
+
20
+ You may make copies for that permitted use and provide copies to people
21
+ acting on your company's behalf solely to carry out that permitted use,
22
+ subject to the complete terms and notices of this license. Each recipient
23
+ must have their own applicable permission; this is not a sublicensing right.
24
+
25
+ The copyright and patent grants, conditions, notices, limitations, and other
26
+ terms in Part B apply to this additional permitted purpose. Part A expands
27
+ the permitted purposes; it does not narrow any permission in Part B.
28
+
29
+ ### 2. Employee threshold
30
+
31
+ Fewer than two means zero or one employee. The employee count includes all
32
+ employees of your company as a whole, including the organizations within
33
+ "your company" as defined in Part B. It is not limited to a department,
34
+ project, installation, or the people who use the software.
35
+
36
+ Count each full-time or part-time employee as one person, without adjusting
37
+ for hours worked. A founder, owner, or director counts when that person is
38
+ also an employee. Ownership or a directorship alone does not make a person
39
+ an employee for this threshold. Genuine independent contractors are not
40
+ counted as employees. A person's actual employment status under applicable
41
+ law controls, not a title or label chosen to avoid this threshold.
42
+
43
+ ### 3. Clients and commercial services
44
+
45
+ When you use the software to investigate a client's repositories, data,
46
+ products, or engineering operations, both your company and the client's
47
+ company must qualify under this permission or have appropriate separate
48
+ commercial rights. Running the software through a contractor, affiliate,
49
+ or other intermediary does not exempt the client from this requirement.
50
+ The employee count is applied to each company and its controlled group as
51
+ defined in Part B.
52
+
53
+ This additional permission does not authorize selling or licensing copies
54
+ of the software, or offering the software itself as a hosted or managed
55
+ service to third parties. Those uses require a separate written commercial
56
+ license unless independently permitted by Part B or a prior applicable
57
+ grant. Using the software internally to develop your company's own product
58
+ does not, by itself, mean you are offering the software as a service.
59
+
60
+ ### 4. Continuing eligibility and commercial licensing
61
+
62
+ Eligibility must hold while you exercise this additional permission. If
63
+ your company reaches two employees, obtain a separate written commercial
64
+ license from the licensor before continuing use for the additional business
65
+ purpose. This requirement does not affect uses independently permitted by
66
+ Part B. Previous compliant use does not become a violation merely because
67
+ the company later grows.
68
+
69
+ Commercial rights outside these public permissions require a separate
70
+ written agreement with Vincent Wargnier. Fees, scope, and any service-provider
71
+ rights are set by that agreement. Neither downloading the software nor
72
+ making an inquiry grants additional commercial rights or creates an
73
+ automatic payment obligation.
74
+
75
+ ### 5. Redistribution, other rights, and earlier grants
76
+
77
+ Preserve this complete license, including Parts A and B, and the required
78
+ notices when distributing the software under it. Every recipient may rely
79
+ on Part A if they independently satisfy its conditions. The licensor grants
80
+ the permissions directly; you may not remove these conditions or represent
81
+ that a recipient has unrestricted commercial rights under this license.
82
+
83
+ Third-party components retain their own licenses. Nothing here withdraws
84
+ rights previously granted under Apache 2.0, PolyForm Noncommercial 1.0.0,
85
+ or another applicable license. This license grants no exclusive right over
86
+ all installation, consulting, or support services.
87
+
88
+ ## Part B — PolyForm Noncommercial License 1.0.0
89
+
90
+ The original license text follows unchanged.
91
+
92
+ ---
93
+
94
+ # PolyForm Noncommercial License 1.0.0
95
+
96
+ <https://polyformproject.org/licenses/noncommercial/1.0.0>
97
+
98
+ ## Acceptance
99
+
100
+ In order to get any license under these terms, you must agree
101
+ to them as both strict obligations and conditions to all
102
+ your licenses.
103
+
104
+ ## Copyright License
105
+
106
+ The licensor grants you a copyright license for the
107
+ software to do everything you might do with the software
108
+ that would otherwise infringe the licensor's copyright
109
+ in it for any permitted purpose. However, you may
110
+ only distribute the software according to [Distribution
111
+ License](#distribution-license) and make changes or new works
112
+ based on the software according to [Changes and New Works
113
+ License](#changes-and-new-works-license).
114
+
115
+ ## Distribution License
116
+
117
+ The licensor grants you an additional copyright license
118
+ to distribute copies of the software. Your license
119
+ to distribute covers distributing the software with
120
+ changes and new works permitted by [Changes and New Works
121
+ License](#changes-and-new-works-license).
122
+
123
+ ## Notices
124
+
125
+ You must ensure that anyone who gets a copy of any part of
126
+ the software from you also gets a copy of these terms or the
127
+ URL for them above, as well as copies of any plain-text lines
128
+ beginning with `Required Notice:` that the licensor provided
129
+ with the software. For example:
130
+
131
+ > Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
132
+
133
+ ## Changes and New Works License
134
+
135
+ The licensor grants you an additional copyright license to
136
+ make changes and new works based on the software for any
137
+ permitted purpose.
138
+
139
+ ## Patent License
140
+
141
+ The licensor grants you a patent license for the software that
142
+ covers patent claims the licensor can license, or becomes able
143
+ to license, that you would infringe by using the software.
144
+
145
+ ## Noncommercial Purposes
146
+
147
+ Any noncommercial purpose is a permitted purpose.
148
+
149
+ ## Personal Uses
150
+
151
+ Personal use for research, experiment, and testing for
152
+ the benefit of public knowledge, personal study, private
153
+ entertainment, hobby projects, amateur pursuits, or religious
154
+ observance, without any anticipated commercial application,
155
+ is use for a permitted purpose.
156
+
157
+ ## Noncommercial Organizations
158
+
159
+ Use by any charitable organization, educational institution,
160
+ public research organization, public safety or health
161
+ organization, environmental protection organization,
162
+ or government institution is use for a permitted purpose
163
+ regardless of the source of funding or obligations resulting
164
+ from the funding.
165
+
166
+ ## Fair Use
167
+
168
+ You may have "fair use" rights for the software under the
169
+ law. These terms do not limit them.
170
+
171
+ ## No Other Rights
172
+
173
+ These terms do not allow you to sublicense or transfer any of
174
+ your licenses to anyone else, or prevent the licensor from
175
+ granting licenses to anyone else. These terms do not imply
176
+ any other licenses.
177
+
178
+ ## Patent Defense
179
+
180
+ If you make any written claim that the software infringes or
181
+ contributes to infringement of any patent, your patent license
182
+ for the software granted under these terms ends immediately. If
183
+ your company makes such a claim, your patent license ends
184
+ immediately for work on behalf of your company.
185
+
186
+ ## Violations
187
+
188
+ The first time you are notified in writing that you have
189
+ violated any of these terms, or done anything with the software
190
+ not covered by your licenses, your licenses can nonetheless
191
+ continue if you come into full compliance with these terms,
192
+ and take practical steps to correct past violations, within
193
+ 32 days of receiving notice. Otherwise, all your licenses
194
+ end immediately.
195
+
196
+ ## No Liability
197
+
198
+ ***As far as the law allows, the software comes as is, without
199
+ any warranty or condition, and the licensor will not be liable
200
+ to you for any damages arising out of these terms or the use
201
+ or nature of the software, under any kind of legal claim.***
202
+
203
+ ## Definitions
204
+
205
+ The **licensor** is the individual or entity offering these
206
+ terms, and the **software** is the software the licensor makes
207
+ available under these terms.
208
+
209
+ **You** refers to the individual or entity agreeing to these
210
+ terms.
211
+
212
+ **Your company** is any legal entity, sole proprietorship,
213
+ or other kind of organization that you work for, plus all
214
+ organizations that have control over, are under the control of,
215
+ or are under common control with that organization. **Control**
216
+ means ownership of substantially all the assets of an entity,
217
+ or the power to direct its management and policies by vote,
218
+ contract, or otherwise. Control can be direct or indirect.
219
+
220
+ **Your licenses** are all the licenses granted to you for the
221
+ software under these terms.
222
+
223
+ **Use** means anything you do with the software requiring one
224
+ of your licenses.
package/LICENSING.md ADDED
@@ -0,0 +1,63 @@
1
+ # Licensing and company deployments
2
+
3
+ **Free for personal use and internal business use by companies with fewer than 2 employees. Business use by companies with 2 or more employees requires a paid commercial license.**
4
+
5
+ ultimatehuman is source-available under the **ultimatehuman Community License 1.0**. It combines the unchanged PolyForm Noncommercial License 1.0.0 with an additional small-business permission. The complete terms are in [LICENSE](LICENSE); this guide explains them and does not replace them. This is a custom license, not MIT, the standard PolyForm Small Business license, or an OSI-approved open-source license.
6
+
7
+ ## Who can use it free?
8
+
9
+ | Situation | Terms |
10
+ | --- | --- |
11
+ | Personal study, experiments, or hobby projects without anticipated commercial application | Free under the base license |
12
+ | Other purposes permitted by PolyForm Noncommercial, including its specified nonprofit, educational, research, and government uses | Free under the base license |
13
+ | A business with 0 employees using it on its own projects | Free under the small-business permission |
14
+ | A business with 1 employee using it on its own projects | Free under the small-business permission |
15
+ | A business with 2 or more employees using it for its business | Paid commercial license required |
16
+ | A one-person contractor using it on a client's projects | The contractor's business and the client must each qualify or have appropriate commercial rights |
17
+ | Selling, licensing, or hosting ultimatehuman itself for customers | Separate commercial license required, regardless of employee count |
18
+
19
+ “Fewer than 2” means **0 or 1**, not 2. The free business permission includes commercial product development and operation of your own business. You do not need to request a license or pay a fee when you qualify; the public license grants that permission directly.
20
+
21
+ ## How employees are counted
22
+
23
+ - Count employees across the whole business and the entities controlling it, controlled by it, or under common control with it. A one-person team inside a larger company does not qualify independently.
24
+ - Count each full-time or part-time employee as one person. This is headcount, not full-time equivalents or the number of ultimatehuman users.
25
+ - Founders, owners, and directors count if they are employees. They do not count solely because they own or direct the business.
26
+ - Genuine independent contractors are not employees for this threshold. Actual employment status applies; relabeling an employee does not change the count.
27
+ - When working on a client's repositories, data, or engineering operations, the client's eligibility also applies. A larger company cannot qualify by having a sole contractor run ultimatehuman for it.
28
+
29
+ For example, a sole founder with no employees can use ultimatehuman free on their business's projects. A company with two employees needs a commercial license for business use, even if only one employee uses ultimatehuman. Two founders with no employment relationship to their business are not two employees under this definition.
30
+
31
+ Eligibility must hold while using the small-business permission. If the count reaches 2, obtain a commercial license before continuing business use. There is no automatic charge or published price implied by this change; fees and scope are agreed in writing. This release adds license terms, not software that counts staff or disables an installation.
32
+
33
+ ## Paid licenses and installation
34
+
35
+ For business use outside the free permission, obtain a separate written agreement from **Vincent Wargnier**. Installation, configuration, and ongoing operation can be included in that agreement.
36
+
37
+ [Request a commercial license or company installation](https://github.com/vincent38wargnier/ultimatehuman/issues/new?title=Commercial%20license%20inquiry). An inquiry does not grant a license. Keep credentials and confidential company information out of public issues.
38
+
39
+ Commercial agreements specify the customer, permitted use, deployment scope, fees, and any rights for contractors, hosting providers, resellers, or installers. The small-business permission does not authorize offering ultimatehuman itself as a commercial product or hosted service. It does not establish an exclusive right over every possible consulting or support service; any intended service-provider restrictions need to be addressed in the applicable agreement.
40
+
41
+ ## Earlier versions
42
+
43
+ | Revision or package | Terms originally offered |
44
+ | --- | --- |
45
+ | Through commit [`521cbafe8384eefcf5c8d6e81f45e13efa5151f1`](https://github.com/vincent38wargnier/ultimatehuman/tree/521cbafe8384eefcf5c8d6e81f45e13efa5151f1) | Apache License 2.0 |
46
+ | npm `ultimatehuman@0.1.0` | PolyForm Noncommercial 1.0.0 |
47
+ | npm `ultimatehuman@0.1.1` and revisions carrying the Community License | The complete terms in their included `LICENSE` |
48
+
49
+ This change does **not** withdraw previously granted rights or rewrite earlier release archives. Code already licensed under Apache 2.0 remains usable under those grants, including for commercial purposes when the Apache conditions are met. Earlier PolyForm grants also remain available for the material offered under them. The additional small-business permission is included in revisions and packages carrying the new complete license.
50
+
51
+ ## Dependencies and contributions
52
+
53
+ Third-party code, fonts, and dependencies retain their own licenses. The npm distribution includes their texts in `THIRD_PARTY_NOTICES.txt`. This project's license does not replace their terms or claim ownership of them.
54
+
55
+ Commercial licensing depends on the licensor having the necessary rights in the relevant code. External copyrightable contributions require the written rights described in [CONTRIBUTING.md](CONTRIBUTING.md) before merging.
56
+
57
+ ## References
58
+
59
+ - [Complete ultimatehuman terms](LICENSE)
60
+ - [Official PolyForm Noncommercial terms](https://polyformproject.org/licenses/noncommercial/1.0.0)
61
+ - [npm custom-license metadata](https://docs.npmjs.com/cli/v11/configuring-npm/package-json/#license)
62
+ - [Open Source Definition](https://opensource.org/osd): restricting business use means this is source-available, not OSI-approved open source.
63
+ - [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0.txt): earlier grants are not revoked by this change.
package/NOTICE ADDED
@@ -0,0 +1,8 @@
1
+ Required Notice: Copyright (c) 2026 Vincent Wargnier
2
+ Required Notice: ultimatehuman — https://github.com/vincent38wargnier/ultimatehuman
3
+
4
+ Public license: ultimatehuman Community License 1.0. See LICENSE.
5
+ Includes PolyForm Noncommercial 1.0.0 and an additional permission for
6
+ internal business use by companies with fewer than two employees.
7
+ Eligibility, commercial licensing, and earlier grants: see LICENSING.md.
8
+ Third-party dependencies remain under their respective licenses.
package/README.md CHANGED
@@ -1,3 +1,175 @@
1
- # Temporary Holding Version
1
+ <p align="center">
2
+ <img src="https://raw.githubusercontent.com/vincent38wargnier/ultimatehuman/main/docs/assets/hero.svg" alt="ultimatehuman — AI investigates. You decide." width="100%" />
3
+ </p>
2
4
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
5
+ <p align="center">
6
+ <a href="https://www.npmjs.com/package/ultimatehuman"><img src="https://img.shields.io/npm/v/ultimatehuman?color=d3ff5f&labelColor=152018" alt="npm version" /></a>
7
+ <a href="https://github.com/vincent38wargnier/ultimatehuman/blob/main/LICENSING.md"><img src="https://img.shields.io/badge/license-Community-d3ff5f?labelColor=152018" alt="ultimatehuman Community License" /></a>
8
+ <a href="https://github.com/vincent38wargnier/ultimatehuman/actions/workflows/check.yml"><img src="https://github.com/vincent38wargnier/ultimatehuman/actions/workflows/check.yml/badge.svg" alt="Build and package checks" /></a>
9
+ </p>
10
+
11
+ **Your production data already tells you where the product is breaking. ultimatehuman connects it to your code and brings you the investigation, the evidence, and a decision.**
12
+
13
+ Run it on your machine. Set it up through chat. Watch the pipeline work. Review what deserves action.
14
+
15
+ **Free for personal use and internal business use by companies with fewer than 2 employees. Businesses with 2 or more employees need a paid license for business use.** [Eligibility and commercial licensing](https://github.com/vincent38wargnier/ultimatehuman/blob/main/LICENSING.md)
16
+
17
+ ## Start here
18
+
19
+ ```sh
20
+ npx ultimatehuman@latest
21
+ ```
22
+
23
+ Requires **macOS or Linux**, **Node.js 22.13+**, **Git**, and **Claude Code installed and signed in**. [Install Node.js](https://nodejs.org/en/download) · [Set up Claude Code](https://code.claude.com/docs/en/quickstart)
24
+
25
+ The CLI verifies your existing Claude account, starts the local engine, and opens your browser. **Continue in Chat.** Chat and investigations use your configured Claude Code account and count toward its usage limits.
26
+
27
+ Start with something like:
28
+
29
+ > My project is Acme. The frontend is in ~/code/acme-web and the API is in ~/code/acme-api. Help me set up the first pipeline.
30
+
31
+ 1. **Connect the project.** Chat inspects your repositories and identifies frameworks, tests, and tracking tools.
32
+ 2. **Connect the signals.** If you already use PostHog or Datadog, connect it through a private credential form inside chat. No tracking yet? Start with a code-only Security check, or ask for help adding tracking.
33
+ 3. **Run one pipeline.** Review its scope and schedule, then ask it to run. Follow the investigation in **Pipeline live**.
34
+ 4. **Make the decision.** Open a finding in **Review**, inspect its evidence, and accept, dismiss, or set it aside.
35
+
36
+ Run the same command again to reopen your workspace. Your repositories, settings, and conversation are preserved.
37
+
38
+ ## Less chasing. More deciding.
39
+
40
+ A log is a symptom. A replay is a clue. A repository explains how the failure could happen. Putting those pieces together is the work.
41
+
42
+ ultimatehuman runs that investigation for you: it groups signals, reads the relevant code, challenges the explanation, and checks the evidence before a finding reaches your review queue. If the evidence does not hold up, the pipeline can finish without a finding.
43
+
44
+ **The AI does not approve its own work. You make the decision.**
45
+
46
+ <p align="center">
47
+ <img src="https://raw.githubusercontent.com/vincent38wargnier/ultimatehuman/main/docs/assets/pipeline.svg" alt="Production signals and repository code flow through investigation and evidence checks to a human review." width="100%" />
48
+ </p>
49
+
50
+ ## One conversation. The whole system in view.
51
+
52
+ | Workspace | What you do there |
53
+ | --- | --- |
54
+ | **Chat** | Connect repositories and sources, create pipelines, set schedules, and change guidelines in plain language. |
55
+ | **Setup** | See which repositories are wired, which sources are connected, and what to set up next. |
56
+ | **Pipeline live** | Follow queued work, active investigations, evidence checks, blockers, and decisions across the system. |
57
+ | **Review** | Read the problem, impact, and supporting evidence. Record your decision and export an issue draft. |
58
+
59
+ The browser, terminal, and optional Telegram connection share one conversation. Chat offers the models available in your installed Claude Code, with **Opus 5.5** as its default. Changing the chat model leaves pipeline models unchanged.
60
+
61
+ ## See the product
62
+
63
+ Screenshots use fictional Acme repositories and sample data. Chat and Pipeline live show the shipped `0.1.0` interface; the Review example below also illustrates its screenshot viewer with demo attachments.
64
+
65
+ ### Set up through chat
66
+
67
+ Tell it which repositories belong to your project and when to investigate. Chat explains the scope, identifies existing tracking tools, and guides you to the first review.
68
+
69
+ ![Chat showing a project's repositories, security review schedule, and next steps](https://raw.githubusercontent.com/vincent38wargnier/ultimatehuman/main/docs/assets/screenshots/chat.png)
70
+
71
+ ### Follow the pipeline live
72
+
73
+ See what is running, what is being checked, and what needs your decision. Expand a run to inspect its individual steps.
74
+
75
+ ![Pipeline live showing verification in progress, two findings awaiting a decision, and the run's agent steps](https://raw.githubusercontent.com/vincent38wargnier/ultimatehuman/main/docs/assets/screenshots/pipeline-live.png)
76
+
77
+ ### Make the decision
78
+
79
+ **A valid ZIP code. A failed checkout. An explanation you can inspect.**
80
+
81
+ In this example, a shopper enters `02108`. The checkout converts it to `2108`, and the API rejects the order. The ticket brings together the cause, code reference, and two screenshots: the checkout failure and the request behind it.
82
+
83
+ ![Review ticket for a checkout bug, with two screenshot evidence thumbnails, the root cause, and Accept, Dismiss, and Not now choices](https://raw.githubusercontent.com/vincent38wargnier/ultimatehuman/main/docs/assets/screenshots/review.png)
84
+
85
+ The original Review viewer opens each screenshot at full size, with navigation between the evidence images.
86
+
87
+ ![Full-screen evidence viewer showing a valid ZIP code rejected by the fictional Acme checkout](https://raw.githubusercontent.com/vincent38wargnier/ultimatehuman/main/docs/assets/screenshots/review-evidence.png)
88
+
89
+ [View the checkout screenshot](https://github.com/vincent38wargnier/ultimatehuman/blob/main/docs/assets/screenshots/checkout-failure.png) · [View the request trace](https://github.com/vincent38wargnier/ultimatehuman/blob/main/docs/assets/screenshots/checkout-request.png)
90
+
91
+ **Example scope:** these attachments come from a local demo. Version `0.1.0` does not yet connect screenshot attachments to review tickets or capture them automatically. The shipped release records investigation decisions; automated fixes and merges are future stages. [Screenshot details](https://github.com/vincent38wargnier/ultimatehuman/blob/main/docs/assets/screenshots/README.md)
92
+
93
+ ## Start with the tools you already use
94
+
95
+ | Input | What it unlocks today |
96
+ | --- | --- |
97
+ | **PostHog** | Investigate errors and user behavior with event and session evidence. |
98
+ | **Datadog** | Investigate recurring failures using error logs and events. |
99
+ | **Git repositories** | Connect a finding to its code; investigate security risks without a tracker. |
100
+ | **Findings API** | Submit a finding from another tool into the same review workflow. |
101
+
102
+ Detection is not connection: finding an SDK in your repository does not grant access to its data. Chat opens a credential form, provides setup guidance, and checks access before treating a source as connected. Keys are saved on your machine, outside the chat transcript.
103
+
104
+ Two pipeline templates are included. You can change their scope, schedule, timezone, models, and guidelines through chat.
105
+
106
+ | Pipeline | Investigates | Default schedule | Findings per run |
107
+ | --- | --- | --- | --- |
108
+ | **Bug radar** | User-facing bugs from connected tracking data | Daily, 07:00 | Up to 5; at least 2 evidence items |
109
+ | **Security check** | Exposed secrets, dependencies, and authentication/authorization patterns | Daily, 06:30 | Up to 3; at least 1 evidence item |
110
+
111
+ Schedules use the engine's timezone unless you specify one. These are limits, not quotas. A quiet or inconclusive investigation may produce no tickets.
112
+
113
+ ## Your machine. Your account. Your judgment.
114
+
115
+ - **Local workspace.** The engine, dashboard, configuration, and findings run on your machine. Relevant code and evidence are sent to your configured AI provider during analysis; connected sources are queried over their APIs.
116
+ - **Read-only investigations.** Autonomous pipelines inspect sources and code. Interactive chat can run shell commands or edit files with approvals shown in the conversation.
117
+ - **Capacity for your own work.** The engine reserves 30% of the account's usage window by default and can pause work when capacity is exhausted.
118
+ - **Explicit outcomes.** Accepting a finding records your decision locally. You can export a Markdown issue draft; acceptance does not merge or deploy code.
119
+
120
+ ## Where this is going
121
+
122
+ The goal is autonomous engineering with a human decision at its center:
123
+
124
+ **Discover → Plan → Fix and test → Human decision → Verify**
125
+
126
+ This first public release delivers the **investigation and review** part: chat setup, real source connections, scheduled pipelines, evidence checks, live progress, and local decisions.
127
+
128
+ Autonomous fixes, browser proof of a fix, pull-request delivery, and deployed verification are the next stages. Sentry collection, automatic database preparation, and direct issue publishing are also not included in this release. [Read the pipeline concept](https://github.com/vincent38wargnier/ultimatehuman/blob/main/docs/concept-and-pipeline.md) · [See the roadmap](https://github.com/vincent38wargnier/ultimatehuman/blob/main/ROADMAP.md)
129
+
130
+ ## A few useful commands
131
+
132
+ | Command | Purpose |
133
+ | --- | --- |
134
+ | `npx ultimatehuman@latest` | Start or reopen the browser workspace |
135
+ | `npx ultimatehuman@latest chat` | Continue the shared conversation in your terminal |
136
+ | `npx ultimatehuman@latest doctor` | Check account access and configuration |
137
+ | `npx ultimatehuman@latest service install` | Keep the engine running after login/restart |
138
+ | `npx ultimatehuman@latest stop` | Stop an engine launched without the background service |
139
+
140
+ Prefer a persistent command? Run `npm install -g ultimatehuman`, then `ultimatehuman`.
141
+
142
+ ### Questions
143
+
144
+ **Do I need a separate API key for Claude?** No. The normal installation uses your existing Claude Code login. Tracker credentials are separate and are requested only when connecting a source.
145
+
146
+ **Can one project include several repositories?** Yes. Tell chat which repositories belong together, such as your frontend and API.
147
+
148
+ **Do I need PostHog or Datadog?** No. The Security check works from repository code. Production bug investigations need a connected source with relevant data.
149
+
150
+ **Does it run while my laptop is closed?** The machine must be awake and online. Use an always-on machine for continuous operation. The optional background service handles restarts, not sleep.
151
+
152
+ **Where is my data?** In `~/.ultimatehuman` by default. Use `ULTIMATEHUMAN_HOME` to select another workspace. [Configuration and development](https://github.com/vincent38wargnier/ultimatehuman/blob/main/docs/development.md)
153
+
154
+ ## Build with us
155
+
156
+ This is an early source-available release. Useful bug reports include the installed version, the steps you took, and what you expected. Remove credentials and private project data before posting.
157
+
158
+ [Report a problem](https://github.com/vincent38wargnier/ultimatehuman/issues) · [Contribute](https://github.com/vincent38wargnier/ultimatehuman/blob/main/CONTRIBUTING.md) · [Run from source](https://github.com/vincent38wargnier/ultimatehuman/blob/main/docs/development.md) · [Agent installation guide](https://github.com/vincent38wargnier/ultimatehuman/blob/main/docs/agent-install.md)
159
+
160
+ ## License and commercial use
161
+
162
+ Source-available under the [ultimatehuman Community License 1.0](https://github.com/vincent38wargnier/ultimatehuman/blob/main/LICENSE). This combines PolyForm Noncommercial 1.0.0 with an additional permission for qualifying small businesses. It is a custom license, not MIT or an OSI-approved open-source license.
163
+
164
+ | Use | Terms |
165
+ | --- | --- |
166
+ | Personal and other permitted noncommercial use | Free |
167
+ | Internal business use with 0 or 1 employee | Free under the small-business permission |
168
+ | Business use with 2 or more employees | Separate paid commercial license required |
169
+ | Selling or hosting ultimatehuman itself for customers | Separate commercial license required |
170
+
171
+ Count employees across the business and its controlled group, not just ultimatehuman users. Part-time employees count as one person; founders count if they are employees. Work on a client's projects uses the client's headcount too. If the business grows to 2 employees, obtain a commercial license before continuing business use. The underlying license's specified nonprofit, educational, research, and government permissions remain available.
172
+
173
+ [Request a commercial license or company installation from Vincent Wargnier](https://github.com/vincent38wargnier/ultimatehuman/issues/new?title=Commercial%20license%20inquiry).
174
+
175
+ Previously granted rights remain valid, including the earlier Apache-licensed revisions. [Eligibility examples, previous versions, and third-party licenses](https://github.com/vincent38wargnier/ultimatehuman/blob/main/LICENSING.md)