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.
- package/LICENSE +224 -0
- package/LICENSING.md +63 -0
- package/NOTICE +8 -0
- package/README.md +174 -2
- package/THIRD_PARTY_NOTICES.txt +436 -0
- package/dist/cli.mjs +33733 -0
- package/dist/dashboard/assets/ConversationWorkspace-6m6xkkC1.js +16 -0
- package/dist/dashboard/assets/ConversationWorkspace-De5tnYl0.css +1 -0
- package/dist/dashboard/assets/data-provider-CZ2WwK6_.js +1 -0
- package/dist/dashboard/assets/fmt-BRV4RZz4.js +12 -0
- package/dist/dashboard/assets/index-CIpIMh38.js +1 -0
- package/dist/dashboard/assets/index-pC0URNNS.js +2 -0
- package/dist/dashboard/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2 +0 -0
- package/dist/dashboard/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2 +0 -0
- package/dist/dashboard/assets/inter-greek-ext-wght-normal-DlzME5K_.woff2 +0 -0
- package/dist/dashboard/assets/inter-greek-wght-normal-CkhJZR-_.woff2 +0 -0
- package/dist/dashboard/assets/inter-latin-ext-wght-normal-DO1Apj_S.woff2 +0 -0
- package/dist/dashboard/assets/inter-latin-wght-normal-Dx4kXJAl.woff2 +0 -0
- package/dist/dashboard/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2 +0 -0
- package/dist/dashboard/assets/jetbrains-mono-cyrillic-wght-normal-D73BlboJ.woff2 +0 -0
- package/dist/dashboard/assets/jetbrains-mono-greek-wght-normal-Bw9x6K1M.woff2 +0 -0
- package/dist/dashboard/assets/jetbrains-mono-latin-ext-wght-normal-DBQx-q_a.woff2 +0 -0
- package/dist/dashboard/assets/jetbrains-mono-latin-wght-normal-B9CIFXIH.woff2 +0 -0
- package/dist/dashboard/assets/jetbrains-mono-vietnamese-wght-normal-Bt-aOZkq.woff2 +0 -0
- package/dist/dashboard/assets/page-CYCU6xk1.js +3 -0
- package/dist/dashboard/assets/render-card-BRSD9J_M.css +1 -0
- package/dist/dashboard/assets/render-card-C8_wQGAe.js +1 -0
- package/dist/dashboard/favicon.svg +5 -0
- package/dist/dashboard/index.html +14 -0
- 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
|
-
|
|
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
|
-
|
|
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
|
+

|
|
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
|
+

|
|
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
|
+

|
|
84
|
+
|
|
85
|
+
The original Review viewer opens each screenshot at full size, with navigation between the evidence images.
|
|
86
|
+
|
|
87
|
+

|
|
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)
|