<feed xmlns='http://www.w3.org/2005/Atom'>
<title>ghostty.git/CONTRIBUTING.md, branch main</title>
<subtitle>Unnamed repository; edit this file 'description' to name the repository.
</subtitle>
<link rel='alternate' type='text/html' href='https://git.belthelziquor.com/ghostty.git/'/>
<entry>
<title>ai: add `gh-issue` command to help diagnose GitHub issues</title>
<updated>2025-09-04T20:56:50+00:00</updated>
<author>
<name>Mitchell Hashimoto</name>
<email>m@mitchellh.com</email>
</author>
<published>2025-09-04T19:29:59+00:00</published>
<link rel='alternate' type='text/html' href='https://git.belthelziquor.com/ghostty.git/commit/?id=ee573ebd36ad7ca63eaf1328d4ff0de0a1a106cc'/>
<id>ee573ebd36ad7ca63eaf1328d4ff0de0a1a106cc</id>
<content type='text'>
This enables agents (namely Amp) to use `/gh-issue &lt;number/url&gt;` to 
begin diagnosing a GitHub issue, explaining the problem, and suggesting
a plan of action. This action explicitly prompts the AI to not write
code.

I've used this manually for months with good results, so now I'm
formalizing it in the repo for other contributors.

Example diagnosing #8523:

https://ampcode.com/threads/T-3e26e8cc-83d1-4e3c-9b5e-02d9111909a7
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
This enables agents (namely Amp) to use `/gh-issue &lt;number/url&gt;` to 
begin diagnosing a GitHub issue, explaining the problem, and suggesting
a plan of action. This action explicitly prompts the AI to not write
code.

I've used this manually for months with good results, so now I'm
formalizing it in the repo for other contributors.

Example diagnosing #8523:

https://ampcode.com/threads/T-3e26e8cc-83d1-4e3c-9b5e-02d9111909a7
</pre>
</div>
</content>
</entry>
<entry>
<title>docs: better integrate CONTRIBUTING into the README</title>
<updated>2025-08-28T22:14:41+00:00</updated>
<author>
<name>Leah Amelia Chen</name>
<email>hi@pluie.me</email>
</author>
<published>2025-08-28T21:48:15+00:00</published>
<link rel='alternate' type='text/html' href='https://git.belthelziquor.com/ghostty.git/commit/?id=f91e6f1764bb8dea3c9e9c77ee39642d85db22b3'/>
<id>f91e6f1764bb8dea3c9e9c77ee39642d85db22b3</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>docs: divide content more evenly between CONTRIBUTING and HACKING</title>
<updated>2025-08-28T22:14:41+00:00</updated>
<author>
<name>Leah Amelia Chen</name>
<email>hi@pluie.me</email>
</author>
<published>2025-08-28T21:20:52+00:00</published>
<link rel='alternate' type='text/html' href='https://git.belthelziquor.com/ghostty.git/commit/?id=f802d336525750a81066676a3d20f135deb5e522'/>
<id>f802d336525750a81066676a3d20f135deb5e522</id>
<content type='text'>
CONTRIBUTING should now solely be about the contribution *process*
while HACKING goes into the technical details
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
CONTRIBUTING should now solely be about the contribution *process*
while HACKING goes into the technical details
</pre>
</div>
</content>
</entry>
<entry>
<title>build: add run-valgrind and test-valgrind steps</title>
<updated>2025-08-20T18:43:48+00:00</updated>
<author>
<name>Mitchell Hashimoto</name>
<email>m@mitchellh.com</email>
</author>
<published>2025-08-20T18:09:05+00:00</published>
<link rel='alternate' type='text/html' href='https://git.belthelziquor.com/ghostty.git/commit/?id=f87213c2f68867c7cca2befdd0a75d94f289e2b6'/>
<id>f87213c2f68867c7cca2befdd0a75d94f289e2b6</id>
<content type='text'>
This adds two explicit `zig build` steps: `run-valgrind` and
`test-valgrind` to run the Ghostty exe or tests under Valgrind,
respectively.

This simplifies the manual Valgrind calls in a few ways:

1. It automatically sets the CPU to baseline, which is a frequent and
   requirement for Valgrind on newer CPUs, and generally safe.

2. It sets up the rather complicated set of flags to call Valgrind with,
   importantly setting up our suppressions.

3. It enables pairing it with the typical and comfortable workflow of
   specifying extra args (with `--`) or flags like `-Dtest-filter` for
   tests.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
This adds two explicit `zig build` steps: `run-valgrind` and
`test-valgrind` to run the Ghostty exe or tests under Valgrind,
respectively.

This simplifies the manual Valgrind calls in a few ways:

1. It automatically sets the CPU to baseline, which is a frequent and
   requirement for Valgrind on newer CPUs, and generally safe.

2. It sets up the rather complicated set of flags to call Valgrind with,
   importantly setting up our suppressions.

3. It enables pairing it with the typical and comfortable workflow of
   specifying extra args (with `--`) or flags like `-Dtest-filter` for
   tests.
</pre>
</div>
</content>
</entry>
<entry>
<title>contributing: add some notes about running valgrind</title>
<updated>2025-08-20T14:03:48+00:00</updated>
<author>
<name>Jeffrey C. Ollie</name>
<email>jeff@ocjtech.us</email>
</author>
<published>2025-08-20T14:03:48+00:00</published>
<link rel='alternate' type='text/html' href='https://git.belthelziquor.com/ghostty.git/commit/?id=60327320015bcf527a6a3ba76ebc171a2a23baa0'/>
<id>60327320015bcf527a6a3ba76ebc171a2a23baa0</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>AI tooling must be disclosed for contributions</title>
<updated>2025-08-19T22:02:31+00:00</updated>
<author>
<name>Mitchell Hashimoto</name>
<email>m@mitchellh.com</email>
</author>
<published>2025-08-19T21:40:42+00:00</published>
<link rel='alternate' type='text/html' href='https://git.belthelziquor.com/ghostty.git/commit/?id=babe923c8c0460563a5f49e50e361fdab634ec47'/>
<id>babe923c8c0460563a5f49e50e361fdab634ec47</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Fix typo in VM Acceptance Criteria ('The' → 'They')</title>
<updated>2025-07-28T15:57:48+00:00</updated>
<author>
<name>Ahmed Harabi</name>
<email>123783548+ahmedharabi@users.noreply.github.com</email>
</author>
<published>2025-07-28T15:57:48+00:00</published>
<link rel='alternate' type='text/html' href='https://git.belthelziquor.com/ghostty.git/commit/?id=87bb949a9306619fe123e9075a5739f562975421'/>
<id>87bb949a9306619fe123e9075a5739f562975421</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>contributing: link to po/README_CONTRIBUTORS.md</title>
<updated>2025-03-14T07:46:06+00:00</updated>
<author>
<name>Leah Amelia Chen</name>
<email>hi@pluie.me</email>
</author>
<published>2025-03-14T07:46:06+00:00</published>
<link rel='alternate' type='text/html' href='https://git.belthelziquor.com/ghostty.git/commit/?id=07b653bd71f00b2650fe8e5e17a6ca1225c02f52'/>
<id>07b653bd71f00b2650fe8e5e17a6ca1225c02f52</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>contributing: fix link to Translator's Guide</title>
<updated>2025-03-14T07:44:04+00:00</updated>
<author>
<name>Leah Amelia Chen</name>
<email>hi@pluie.me</email>
</author>
<published>2025-03-14T07:44:04+00:00</published>
<link rel='alternate' type='text/html' href='https://git.belthelziquor.com/ghostty.git/commit/?id=e8101c113613d3dbb37dc9559c71db7b4f34bb44'/>
<id>e8101c113613d3dbb37dc9559c71db7b4f34bb44</id>
<content type='text'>
For some reason it pointed to the Contributor's Guide instead...
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
For some reason it pointed to the Contributor's Guide instead...
</pre>
</div>
</content>
</entry>
<entry>
<title>gtk: add localization support, take 3</title>
<updated>2025-03-03T09:19:58+00:00</updated>
<author>
<name>Leah Amelia Chen</name>
<email>hi@pluie.me</email>
</author>
<published>2025-02-25T21:54:48+00:00</published>
<link rel='alternate' type='text/html' href='https://git.belthelziquor.com/ghostty.git/commit/?id=9360afd29ff4884733a0015315821c7f3cddd20a'/>
<id>9360afd29ff4884733a0015315821c7f3cddd20a</id>
<content type='text'>
This is my third (!) attempt at implementing localization support.
By leveraging GTK builder to do most of the `gettext` calls, I
can avoid the whole mess about missing symbols on non-glibc platforms.

Added some documentation too for contributors and translators,
just for good measure.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
This is my third (!) attempt at implementing localization support.
By leveraging GTK builder to do most of the `gettext` calls, I
can avoid the whole mess about missing symbols on non-glibc platforms.

Added some documentation too for contributors and translators,
just for good measure.
</pre>
</div>
</content>
</entry>
</feed>
