Asqi: A codebase explorer designed to help navigate and understand Git projects

https://dev.asqi.io/

by guitarsteve • 2 years ago

101 38 2 years ago

dev.asqi.io

localfirst• 2 years ago

tools like Greptile (which this seems close to) to understand Git projects were one time use for me (rendering monthly subscription pointless)

once how to properly use github search especially

also not sure about the web design i guess there are some tools where this works

st_asqi16• 2 years ago

I wanted to say, this is really thoughtful comment and thank you. I love getting ideas like this about the business model and product/market fit.

The second half of the product is a lot more about everyday features e.g. "whose branches collide with mine" or "what are all the upcoming changes in this module", that type of thing. I'm hoping that shores up the long-termism a bit. We'll have to see, though; this whole thing is kind of an experiment and it may just be a miss, or serve a very specialized use case. If you have more thoughts, I'd welcome them.

sdwr• 2 years ago

There's definitely room for a good product here. Idk about advanced use, but from a naive view, git UI and vscode blame plugins are awkward to use.

esafak• 2 years ago

The demo is not working for me: https://demo.dev.asqi.io/

BChass• 2 years ago

Same here. Looks like some property of 'p' can't be read in.

websap2• 2 years ago

Same demo not working for me, asks me to install a React App on the address bar in Chrome. No chance I'm installing something random.

st_asqi16• 2 years ago

Yeah you definitely don't need to install anything. I don't know how to deploy React apps apparently (will try to fix), but it's just a regular website and I would never ask users to expect anything else.

Update: it's because create-react-app creates manifest.json in public/, which causes Chrome to prompt you for this. I've deleted it in the latest container image and I'll redeploy once traffic dies down a bit.

gsuuon2• 2 years ago

Same, getting:

  3main.5cc1145c.js:2 TypeError: Cannot read properties of undefined (reading 'p')
    at V.rpc (main.5cc1145c.js:2:23177)
    at V.server_repos (main.5cc1145c.js:2:25611)
    at e (main.5cc1145c.js:2:93041)

Would really like to try this out

st_asqi16• 2 years ago

Got it working again! Sorry about that, server crash possibly from being on HN :)

st_asqi16• 2 years ago

Hi, thanks for trying it out! The server crashed, sorry about that. I need to add a liveness check. It should be working now.

As for comments asking to install React, it's a bug on my end. Create-react-app leaves a manifest.json file in public/, which causes the prompt to appear. I've deleted it in the latest container image but haven't redeployed yet since we've got a lot of active users at the moment.

Anyway, you don't have to install anything, nor will you ever have to, in order to use Asqi.

whitten• 2 years ago

I’m wondering what computer language analysis tools are necessary to make this work for another language. The OG page supplies this info

    Supported languages
    -------------------
    Asqi can provide file-level indexing for everything, 
    and it provides semantic indexing for:

    + C/C++
    + Java
    + Go
    + Rust
    + JavaScript/TypeScript
    + Python

st_asqi16• 2 years ago

It's actually pretty straightforward; we use tree-sitter for parsing and it takes me about 2-3 hours for each language. So I'm planning to add a lot more in the near future.

If you have any that you find especially valuable, let me know and I'll see if I can prioritize them.

l8nite• 2 years ago

Kotlin would be awesome!

modderation2• 2 years ago

With regards to your call for interesting language support, I'd add a very low-priority suggestion for documentation and specification formats. Plain text, Markdown, simple HTML paragraphs and sections. If a new paragraph or sentence is added to a spec, or a MUST becomes a MAY, it'd be neat to surface the context of the change instead of a word/line diff.

As the Semantic History is not yet available, how do you envision it being displayed at the moment? What sort of information are you currently collecting? Is this tracked across the project history? To that end, are you building Tree-Sitter grammars and queries yourself, or are you using the pre-existing grammars and building the language support into Asqi?

For context, I've got a back-burner project that maps reimplemented code (manually mapped, with annotations or structured comments) to identifiable items in an upstream codebase and git repository. When the content of an item is changed upstream, affected downstream code could be flagged for review. It's still early in the design/prototyping phase, but it feels like there's some interesting overlap with Asqi.

celdon253• 2 years ago

Ruby with sorbet would be cool, and C#

snthpy2• 2 years ago

I want to like this but I found the UI too confusing and didn't get anything out of the current experience.

I liked the BBS/ssh server intro and styling but you lost me at the jumpy, nested circular tree chart thingy. Maybe a boring rectangular treemap would work better? Even better if it was rendered in the terminal over ssh...

st_asqi16• 2 years ago

Terminal over ssh? Hahaha don't tempt me :)

I really like this idea. It's not at all what I had in mind for the product, but that's because it had never occurred to me. I'm going to give this some serious thought and see what shakes out.

snthpy2• 2 years ago

Cool. You can get going in no time with Charm Wish (https://github.com/charmbracelet/wish).

Then sprinkle on magic fairy dust with TTE (https://chrisbuilds.github.io/terminaltexteffects/showroom/) so you can still have that epilepsy inducing effect :-p

kjksf• 2 years ago

I like the speed and compactness of the UI.

Hopefully constructive feedback.

1. That message about upcoming feature obscures the code and is actually a big div taking the whole right side, from top to bottom, which blocks events like scrolling with mouse wheel. It's white so it looks like part of code but blocks scrolling of code.

2. those circular things are a gimmick in my mind. And acting on hover is confusing: I move the mouse and things flash wildly.

Give me a clear option to permanently hide the circular thingy.

Only act on click, not mouse over.

3. When I clicked on an enum definition (e.g. in postgres parser) I expected a way to see all places that use that enum. It's not possible or I'm missing something.

4. The "search everywhere" dialog is confusing. Again, a big circular thingy, invisible cursor so I don't even know I can type something and I don't know what I'm searching there. File names? I expect search to be full text search of all files.

5. I was confused by `C-u`. Now I get that it's `Ctrl-u` but make it more obvious . At least in help use the full `Ctrl-u` and add tooltips with full version.

6. The color of tabs is the inverse of what I expect based on pretty much all other software I use. A current tab should have the same color as the panel, so that it looks like it's part of it. Since panel is white, selected tab (e.g. History vs. Tree) should also be white. It's black. Or find some other way to make it clear which tab is selected.

st_asqi16• 2 years ago

Thanks so much for writing this up, it's great! Let me get some coffee and I'll share some thoughts about where we are and where it's going.

brabel• 2 years ago

I was confused by `C-u`.

That's the old fashioned, traditional way to represent shortcuts.

Example:

https://courses.cs.washington.edu/courses/cse351/16wi/sectio...

st_asqi16• 2 years ago

This is absolutely constructive feedback, thank you again for writing it all up. I'll go through point by point and share my thoughts about each one.

Re speed and compactness, thank you! These are two things I really value in UIs, and I optimized Asqi pretty relentlessly to make it fast. It's good to hear that it's appreciated and I'm glad you said something.

1. The "feature coming soon" is awful and embarrassing. It exists because I wanted to make it clear that Asqi has a strong emphasis on history -- in fact, that's fundamentally what it's about -- even though big parts of that feature-space aren't implemented yet. But it was so painful to ship that way; I hate that div so much for blocking my mouse. ...so I'm sorry to you and everyone else that you have to suffer through the existence of that panel.

2a. Circular things, which we internally call bagels, are 100% a gimmick. Ultimately their job is just to look at code top-down, and there are probably better ways to do it although I don't know of any yet. But the problem is that I can be bought (at least in UI terms), and I realized that I really liked the way code looks in concentric circles. So I had these two conflicting thoughts: "this is cool and visually anchors the product", and "this is stupid and no serious person would find it valuable."

I tried rendering diffs in bagel form, which you can see if you shift-click other branches in the history tab to get this URL: https://demo.dev.asqi.io/#fast-libgit2::main,#6818,#6819,#68...::::. So cool, we have multiway diffs rendered in tree form, and now when you hover the elements you see which branches modified each blob. But it still feels like a gimmick because I can't really conclude that it's better than a properly-executed tree view. I don't know how to properly execute a tree view enough to make me dislike the bagel holistically, but if I ever do then the bagel is out. There's plenty to dislike about it.

2b. Hover-actions are central to Asqi's design and I love them, but I'm a sloppy-focus person and that's definitely a minority preference. The flashing is awful and the epilepsy warning was comically embarrassing to have to include. I think a toggle is definitely worthwhile so people don't suffer through my ergonomic biases.

I spent a bunch of time wringing as much see-things leverage out of each screen as I could, except for the despised "feature coming soon" div discussed above, and even did some things like if you hover over a repo-local link in a markdown, scrolling on that link scrolls the link's destination so you can peek into the contents without moving your UI frame of reference. If the user had to click on stuff, they'd have a deeper navigation history and more backtracking.

Having said all that, your perspective is also entirely valid. There's a point where your preferences may diverge from Asqi's design enough that Asqi isn't for you, but I don't think it's here. Asqi needs to meet you on this one by at least providing an option.

3. We don't yet have go-to-references, and perhaps never will. We don't actually have a precise definition/reference linkage for the codebase at all because I don't know how to represent it efficiently across multiple commits. Sourcegraph does it for one revision but not for all to my knowledge (I think if you explore past commits and jump to definition, it jumps into the present, for example). In the first months of Asqi I was so bent on solving this problem that I was designing type-system compilers whose sole purpose was to emit bytecode that implemented the jump-to-definition program across different blob/tree revisions. Then I realized Asqi isn't really about that and I'm not sure that's a product. That said, I also feel the lack of go-to-references and I've been thinking about whether it's implementable. I want it to be because it's a good feature.

4. The Ctrl+K dialog is half-baked and awful. It barely works, in fact. It's supposed to autocomplete words as you type, but it doesn't; instead, it alternates between autocompletions and path completions and expects you to manage focus. It is an abysmal, abhorrent piece of garbage that is second in place only to the semantic-history placeholder div in earning my ire. And like the semantic history panel, I owe you and everyone else an apology for how badly it works. It will be improved or deleted, for everyone's sake.

As for full-text search, I don't think it's going to make it in and for an interesting reason. Asqi's search backend searches for all functions that have ever existed, not just the ones in the current revision. Right now it filters down to just current ones, but "code ghosts" -- code that once existed and is now gone -- are one of the big drivers for having a semantic search feature. So Asqi's search is less about "find stuff in text" and more about "find named entities", at least for now. If the indexes don't get too big, I may also try to add the search-text use case, because I agree it would be useful and I feel the lack of that feature pretty regularly.

5. I really love this point you make, because you're 100% right and I'm kind of an asshat for not seeing it. I wanted Asqi to come across as opinionated, with some old-school sensibilities like Emacs-style key strings because they're compact and have a certain aesthetic appeal. However, Asqi's lack of regular descriptions can be read as not just anachronistic but gatekeeping, which broadly sucks and adds no value. This is another place where Asqi needs to meet the user, not expect the user to meet it. And I never would have thought of this because old-school key strings are second-nature to me. So thank you for saying something.

6. My tabs suck. I should be using a UI library, but threw them together as an early learn-React experiment and never fixed them. Eventually I'd like to get rid of pixels dedicated to things like tabs, but haven't figured out all the details yet. So you can expect crappy UI components like that to be gone soon, and please keep complaining about them (and any others) until they are.

I'm really glad you wrote all this up. It was helpful for me to go through and think about each point you made and how Asqi relates to it. I can't promise that Asqi will become a product you like, but you've given me a lot of room to think about whether it should, and I appreciate having that option. Any thoughts you have going forward are very welcome.

notjoemama2• 2 years ago

Fireship got hacked. Ticketmaster had user info stolen. et al, so when I see:

I log barely enough to determine whether the server has crashed.
We do not collect nor track...

I'm 50% sold by these principles alone.

It's 2024 and not being a data creep is a product feature now.

Thank you.

st_asqi16• 2 years ago

You're very welcome. I wanted to build a product I would use, and being hands-off about customer data is a big part of that. (I was trying to use another code search tool and bailed because it wanted me to sign into Github just to use it locally.) So Asqi will always be designed with that sensibility, including commercial versions which also will never phone home -- licensing will be airgap-compatible.

_lvbh• 2 years ago

Fireship or firebase?

notjoemama2• 2 years ago

Firebase. Thanks. Got it swapped for the YouTube channel.

Asqi: A codebase explorer designed to help navigate and understand Git projects

Related Stories