Ask HN: Any good tools for viewing congressional bills?

joshdata · 2025-06-06T18:00:09 1749232809

Hi. I run GovTrack.

OP may have been unlucky on the timing. The site isn't usually down. Here's the link to the text of H.R. 1 on GovTrack: https://www.govtrack.us/congress/bills/119/hr1/text

We automatically add links to U.S. Code and other citations. In this case Congress.gov is missing rich formatting which we have (I'm not sure why they are missing it for this bill, normally they have it). GovTrack also allows making diff-like comparisons between bill versions and between bills (for example, you can see the last-minute changes made ahead of the vote on this bill).

Source code is available on GitHub if anyone wants to try making GovTrack better, although it's quite complicated because Congressional information is complicated and there's no real money behind this: https://github.com/govtrack/govtrack.us-web/

If anyone has particular thoughts on what would be helpful when viewing bill text --- within the realm of the information that is actually freely available --- I am all ears.

skadamat · 2025-06-06T18:03:15 1749232995

I would love a Genius.com / annotation layer on top of these bills too. Just a dream I'm sharing out loud for no particular reason :) love govtrack in general otherwise!

joshdata · 2025-06-06T18:14:54 1749233694

Without commenting on the merits of that idea, I'll just say that I do not want to be the one who has to moderate user generated content.

manquer · 2025-06-06T18:20:04 1749234004

Only if it is shared annotations is it a problem.

It need not be shared , think more like a public notion/ share point document with comments visible . I.e experts(users) can create their own individual annotated versions and share with others .

As long as there is no single version of the annotations , moderation is not needed

a5huynh · 2025-06-06T16:30:11 1749227411

Side-note, if anyone wants to really dig into all the data available about bills (including votes, attachments, etc.), this is a great place to start: https://github.com/unitedstates/congress

There's excellent documentation on the formats and how to access all the data.

joshdata · 2025-06-06T18:01:08 1749232868

I did much of that so I appreciate you saying that the documentation is excellent. :)

mlinhares · 2025-06-06T18:42:22 1749235342

Thank you for your amazing service to this country!

ellisv · 2025-06-06T18:05:33 1749233133

My friend runs congress.dev which displays diffs

See https://congress.dev/bill/119/House/1/EH

Game_Ender · 2025-06-06T18:26:49 1749234409

This is really great. Reading the bill raw feels like reviewing a diff with context set to 0.

Terr_ · 2025-06-06T19:50:15 1749239415

What I find most frustrating are the bills written as prose-diffs themselves: "In some entirely different piece of law, Foo shall be inserted after Bar, with an overall effect and purpose which will not be described here."

Breza · 2025-06-13T19:27:35 1749842855

One of my friends is a public health lobbyist and she is used to having to explain to stakeholders that THIS formatting mark in the PDF means they're adding text but THAT formatting mark means they're deleting text. It's not immediately obvious and every state has its own way of presenting information. I'd argue that DC does it best, but I haven't looked at every legislature.

ellisv · 2025-06-06T21:19:51 1749244791

Yes. Many bills are modifying the US Code. So the bills are sort of like wordy patches.

CrimsonCape · 2025-06-06T20:59:47 1749243587

This site's font is very pleasant to read. Poking around the raw html reveals webkit antialiasing and a Google font called Nunito Sans.

ellisv · 2025-06-06T21:21:04 1749244864

I’ll let him know you like it.

beej71 · 2025-06-06T16:15:43 1749226543

Should be at fun little XML parser to write, converting the thing to HTML.

Except that it's a government thing so the parser's probably not going to be little. :)

Edit: The thing's basically XHTML without any kind of header. UTF-8 encoding, it looks like. So a conversion tool would just need to wrap it up and add styling.

Edit: Despite hints that it's XHTML, it's not valid XHTML.

Edit: Stick this at the top of the file:

--------------------- 8< ---------------------

<!DOCTYPE html>

<html>

<head>

    <meta name="viewport" content="width=device-width, initial-scale=1" />

    <meta charset="utf-8" />

    <title>H. R. 1</title>

    <style>
    body {
        max-width: 40em;
        margin: auto;
    }
    .lbexTocSectionOLC {
        display: inline-block;
    }
    .lbexTocDivisionOLC {
        margin-top: 5ex;
    }
    </style>

</head>

--------------------- 8< ---------------------

And add this to the bottom of the file:

--------------------- 8< ---------------------

</html>

--------------------- 8< ---------------------

I'll leave it as an exercise to the reader to write a script to do that. Automatically extracting the bill title should be Fun.

gabrielsroka · 2025-06-06T16:59:27 1749229167

<html> and </html> are optional but I didn't try it with this file

https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/...

rhdunn · 2025-06-06T16:27:42 1749227262

See https://www.govinfo.gov/bulkdata/BILLS/resources. Specifically the billres.xsl and associated stylesheets. You can use those with the Saxon XSLT processor to transform the XML files into a HTML view similar to what the PDFs look like.

rhdunn · 2025-06-06T16:36:54 1749227814

There's also https://www.govinfo.gov/bulkdata/FR/resources for federal register XML documents.

Note: it could be worth checking the issues at https://github.com/usgpo/bulk-data/issues as some of those contain fixes and formatting improvements.

ppourmand · 2025-06-06T17:24:52 1749230692

I made an iOS app a while back that lets you read through/follow bills in congress: https://apps.apple.com/us/app/easy-congress/id1522413054

seems to be broken on the "Big Beautiful Bill" right now though :(, I'm taking a a look to see what's going on

codingdave · 2025-06-06T16:27:35 1749227255

PDF is here: https://budget.house.gov/imo/media/doc/one_big_beautiful_bil...

sfennell · 2025-06-06T17:43:29 1749231809

I always go to https://www.govtrack.us/ to view this sort of thing. I don't know if it is _good_ but it's a pretty good tool from my point of view

davidgreenstein · 2025-06-07T01:53:58 1749261238

https://dogeai.chat/ is the leader in the space. Highly recommend. Open source as well.

https://github.com/saihaj/DOGE-AI

jasonthorsness · 2025-06-06T16:42:12 1749228132

Paste the entire thing into the LLM! Maybe people can stop relying on unreliable partisan sources to interpret bills if they have tools to grok the dense weird language in them themselves. I say this even though I was embarrassed yesterday when the LLM misinterpreted something and I posted it - read the reference text behind any summary :/

thuanao · 2025-06-06T17:48:42 1749232122

Government Publishing Office and Library of Congress provides XML formatted bills and all their amendments and a feed of all changes to every bill.

Oh and on the topic of party politics, Bill Clinton was the one who had them put things online in the first place with the GPO Electronic Information Access Enhancement Act, and Barack Obama and the Democrats expanded it via American Recovery and Reinvestment Act of 2009 - not the do-nothing Republicans.

joshdata · 2025-06-06T18:13:13 1749233593

That's not really the right picture.

Congress.gov, originally THOMAS.gov, was a product of the Republican Contract with America take-over of Congress in the mid 1990s. Republicans in Congress, including Rep. Issa for example, were helpful in expanding the information that Congress publishes publicly. In the last 15 years, efforts to make Congress publish more and better-structured information have been relatively bipartisan and, mostly, led by nonpolitical staff. I would not describe Democrats as having been the ones to have exclusively created the access to congressional information that we have today, although Democrats in recent years have led on government transparency and accountability issues generally, beyond the Legislative Branch.

Changes that have required legislation have, as far as I'm aware, not really been influenced by the President, other than being signed into law, since they are Legislative Branch concerns and not Executive Branch concerns.

bavent · 2025-06-06T17:51:47 1749232307

So use an LLM even though you admit immediately they make mistakes and you need to read the entire bill anyways?

jasonthorsness · 2025-06-06T19:27:17 1749238037

Maybe even today an LLM is better than hearing about what the bill contains from social media reposts. The more the actual text is accessible the better (and accessible is not just technically accessible, but also understandable to the reader).

telotortium · 2025-06-06T18:03:01 1749232981

The XML/HTML document looks readable enough - no worse than a GNU HTML manual. You can add a stylesheet if you want.

https://www.congress.gov/119/bills/hr1/generated/BILLS-119hr...

acgourley · 2025-06-06T16:52:09 1749228729

Some friends just made this: https://www.congressionalrag.com/ - they need help from anyone interested, especially around pulling in more data sources.

pacifika · 2025-06-06T16:16:17 1749226577

What about the pdf

ivape · 2025-06-06T16:41:34 1749228094

There should at least be an AI sidebar on congress.gov. I think Americans would learn a whole lot with such a thing, but who wants to foot the bill for this one.

beart · 2025-06-06T16:55:47 1749228947

It's easy to imagine a non-technical user asking the AI a question and implicitly trusting the response as factual, without understanding anything about hallucinations.

justanything · 2025-06-06T18:19:15 1749233955

How do you figure out if the whole or part of the response is a hallucination?

bravesoul2 · 2025-06-08T19:21:31 1749410491

Get a law degree. Then read the entire text word for word?

ivape · 2025-06-06T17:04:46 1749229486

Versus what? An intractable archive of unreadable documents? At the very least they'll get tractable information, which humans will always use on social media to make a point, which will then get fact checked. I prefer that loop. Right now the information is hidden in coffers and never gets taken for a loop.

beart · 2025-06-06T17:40:41 1749231641

A root cause analysis would probably suggest the question - Why are our representatives passing intractable, unreadable documents as law and how can we prevent them from doing that? Or more generally, what changes can be made to our government institutions to improve clarity in communicating actions and decisions to votes?

Yeah, it's naive thinking, and I'm well aware the obfuscation is sometimes the point.

But I digress... My main takeaway here is that we should be considerate of what problems adding AI to the equation may cause. I'm old enough to have seen how "the new big thing" ends up getting applied to every problem space, without really thinking about the consequences.

ivape · 2025-06-06T20:31:33 1749241893

Why are our representatives passing intractable, unreadable documents

Best guess?

1) These are actual laws so they carry all the legal thoroughness

2) Like managers, they don't write the actual code (they don't do the actual writing of the bills). So managers don't really care just how awful the code can be (or in this case, just how intractable the bills are)

3) No one is code reviewing (the public is to uneducated to even do so)

This leads to these things being drafted in the dark of night and passed in the dark of night. I'm open to AI in this case simply to even begin having insight.

maCDzP · 2025-06-06T19:05:08 1749236708

I had a similar problem so I asked Claude to write a MCP that queries my governments ”bill API”. It worked remarkably well.

joeyagreco · 2025-06-06T16:26:18 1749227178

What did you have in mind for viewing options?

enisdenjo · 2025-06-06T20:54:39 1749243279

definitely look at https://dogeai.chat/ by @dogeai_gov on X

Ylpertnodi · 2025-06-06T17:58:00 1749232680

notebooklm.google.com?