Skip to content

Conversation

@daniloc
Copy link
Collaborator

@daniloc daniloc commented Apr 25, 2025

Adding to our endless PR dependency chain, this one awaits our envoy blog post.

This pull adds some documentation to the readme to help developers get their bearings in the project. We now highlight the especially interesting code they'll want to understand to use it themselves.

@daniloc daniloc marked this pull request as ready for review May 6, 2025 14:36
Copy link
Collaborator

@joshsny joshsny left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Really nice - left a couple small things as take it or leave it comments :)

README.md Outdated

## Analytics

Did you know you can capture PostHog analytics even for ancillary products like a command line tool? `src/utils/analytics.ts` is a great example of how to do it.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ancillary is too complex a word for my brain to handle 😂

README.md Outdated

`src/lib/prompts.ts` demonstrates how to wrap a deterministic fence around a chaotic process. Every wizard session gets the same prompt, tailored to the specific files in the project.

These prompts are channeled using `src/utils/query.ts` to an LLM interface we host. This gives us more control: we can be certain of the model version and provider which interpret the prompts and modifies the files. This way, we can find the right tools for the job and again, apply them consistently.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The main goal of routing through the query endpoint is so that we pay on behalf of the user - it's very cheap and not needing them to paste in an api key is advantageous for creating a good flow. might be worth mentioning here!

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nice!

@joshsny joshsny changed the title Update README.md chore: update README.md May 6, 2025
@daniloc daniloc merged commit aab3f06 into main May 6, 2025
6 checks passed
daniloc added a commit that referenced this pull request Oct 27, 2025
* Update README.md

* tweak

* Update README.md

* Update README.md with blog link

* Copy tweaks

* Copy tweaks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants