4360aa192c
Support for pull requests, it's not standard in NIPs yet[1] but there must be two clients that support it to be included in NIPs, n34 is one of them. This support: - Create a new PR `n34 pr new` - Update PR tip `n34 pr update` - View a PR `n34 pr view` - List PRs `n34 pr list` - Add `PR` and `PR-update` kinds as roots in `NostrClient::find_root` - Support issuing statuses for PRs - Support GRASP PR and PR-update - Update the docs [1] https://github.com/nostr-protocol/nips/pull/1966
483 lines
17 KiB
HTML
483 lines
17 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
|
|
<meta property="og:title" content="n34 - CLI for NIP-34 and Nostr Code Collaboration">
|
|
<meta property="og:description" content="An open source CLI for sending and receiving Git issues, patches and comments over the Nostr protocol.">
|
|
<meta property="og:url" content="https://n34.dev">
|
|
<meta property="og:type" content="website">
|
|
|
|
<meta name="twitter:card" content="summary">
|
|
<meta name="twitter:title" content="n34 - CLI for NIP-34 and Nostr Code Collaboration">
|
|
<meta name="twitter:description" content="An open source CLI for sending and receiving Git issues, patches and comments over the Nostr protocol.">
|
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<title>n34 - CLI for NIP-34 and Nostr Code Collaboration</title>
|
|
<style>
|
|
* {
|
|
margin: 0;
|
|
padding: 0;
|
|
box-sizing: border-box;
|
|
}
|
|
body {
|
|
font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
|
|
background: radial-gradient(125% 125% at 50% 90%, #000000 40%, #072607 100%);
|
|
color: #ffffff;
|
|
line-height: 1.6;
|
|
min-height: 100vh;
|
|
}
|
|
.container {
|
|
max-width: 800px;
|
|
margin: 0 auto;
|
|
padding: 60px 20px;
|
|
}
|
|
.hero {
|
|
text-align: center;
|
|
margin-bottom: 80px;
|
|
}
|
|
.hero h1 {
|
|
font-size: 4rem;
|
|
font-weight: 300;
|
|
margin-bottom: 20px;
|
|
letter-spacing: 2px;
|
|
background: linear-gradient(135deg, #ffffff, #cccccc);
|
|
-webkit-background-clip: text;
|
|
-webkit-text-fill-color: transparent;
|
|
background-clip: text;
|
|
}
|
|
.hero p {
|
|
font-size: 1.2rem;
|
|
color: #cccccc;
|
|
margin-bottom: 40px;
|
|
max-width: 600px;
|
|
margin-left: auto;
|
|
margin-right: auto;
|
|
}
|
|
.buttons {
|
|
display: flex;
|
|
gap: 20px;
|
|
justify-content: center;
|
|
flex-wrap: wrap;
|
|
}
|
|
.btn {
|
|
display: inline-block;
|
|
padding: 14px 28px;
|
|
background: transparent;
|
|
border: 2px solid #ffffff;
|
|
color: #ffffff;
|
|
text-decoration: none;
|
|
border-radius: 8px;
|
|
font-weight: 500;
|
|
font-size: 1rem;
|
|
transition: all 0.3s ease;
|
|
min-width: 120px;
|
|
text-align: center;
|
|
}
|
|
.btn:hover {
|
|
background: #ffffff;
|
|
color: #0a0a0a;
|
|
transform: translateY(-2px);
|
|
box-shadow: 0 8px 25px rgba(255, 255, 255, 0.2);
|
|
}
|
|
.section {
|
|
margin-bottom: 60px;
|
|
}
|
|
.section h2 {
|
|
font-size: 2.2rem;
|
|
margin-bottom: 30px;
|
|
color: #ffffff;
|
|
font-weight: 400;
|
|
}
|
|
.section p {
|
|
font-size: 1.1rem;
|
|
color: #e0e0e0;
|
|
margin-bottom: 20px;
|
|
text-align: justify;
|
|
}
|
|
a {
|
|
color: #cccccc;
|
|
text-decoration: underline;
|
|
font-size: 1rem;
|
|
transition: color 0.3s ease;
|
|
}
|
|
a:hover {
|
|
color: #ffffff;
|
|
}
|
|
.features {
|
|
display: grid;
|
|
grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
|
|
gap: 30px;
|
|
margin-bottom: 60px;
|
|
}
|
|
.feature {
|
|
background: #1a1a1a;
|
|
padding: 30px;
|
|
border-radius: 12px;
|
|
border: 1px solid #333;
|
|
transition: transform 0.3s ease, border-color 0.3s ease;
|
|
}
|
|
.feature:hover {
|
|
transform: translateY(-5px);
|
|
border-color: #555;
|
|
}
|
|
.feature h3 {
|
|
font-size: 1.3rem;
|
|
margin-bottom: 15px;
|
|
color: #ffffff;
|
|
display: flex;
|
|
align-items: center;
|
|
gap: 10px;
|
|
}
|
|
.feature-icon {
|
|
font-size: 1.5rem;
|
|
}
|
|
.feature p {
|
|
color: #cccccc;
|
|
font-size: 1rem;
|
|
text-align: left;
|
|
}
|
|
.feature-list {
|
|
background: #111;
|
|
padding: 40px;
|
|
border-radius: 12px;
|
|
border: 1px solid #333;
|
|
margin-bottom: 60px;
|
|
}
|
|
.feature-grid {
|
|
display: grid;
|
|
grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
|
|
gap: 20px;
|
|
margin-top: 20px;
|
|
}
|
|
.feature-column ul {
|
|
list-style: none;
|
|
padding: 0;
|
|
}
|
|
.feature-column li {
|
|
display: flex;
|
|
align-items: center;
|
|
margin-bottom: 12px;
|
|
font-size: 1rem;
|
|
padding: 8px 0;
|
|
}
|
|
.feature-check {
|
|
display: inline-block;
|
|
width: 20px;
|
|
height: 20px;
|
|
margin-right: 12px;
|
|
border-radius: 3px;
|
|
text-align: center;
|
|
line-height: 20px;
|
|
font-size: 12px;
|
|
font-weight: bold;
|
|
flex-shrink: 0;
|
|
}
|
|
.feature-check.completed {
|
|
background: #22c55e;
|
|
color: #ffffff;
|
|
}
|
|
.feature-check.pending {
|
|
background: #374151;
|
|
color: #9ca3af;
|
|
border: 1px solid #4b5563;
|
|
}
|
|
.feature-check.completed::after {
|
|
content: "✓";
|
|
}
|
|
.feature-check.pending::after {
|
|
content: "○";
|
|
}
|
|
.feature-text {
|
|
color: #e0e0e0;
|
|
}
|
|
.feature-text.pending {
|
|
color: #9ca3af;
|
|
}
|
|
.install-section {
|
|
background: #111;
|
|
padding: 40px;
|
|
border-radius: 12px;
|
|
border: 1px solid #333;
|
|
margin-bottom: 60px;
|
|
}
|
|
.install-section h2 {
|
|
margin-bottom: 20px;
|
|
text-align: center;
|
|
}
|
|
.code-block {
|
|
background: #000;
|
|
padding: 20px;
|
|
border-radius: 8px;
|
|
font-family: "Courier New", monospace;
|
|
font-size: 1rem;
|
|
border: 1px solid #333;
|
|
overflow-x: auto;
|
|
margin: 15px 0;
|
|
}
|
|
.code-block p {
|
|
color: #00ff00;
|
|
}
|
|
.code-block p::before {
|
|
content: "$ ";
|
|
color: #888;
|
|
}
|
|
.code-block span::before {
|
|
content: "$ ";
|
|
color: #888;
|
|
}
|
|
.code-block span {
|
|
color: #777;
|
|
}
|
|
.code-block pre {
|
|
color: #00ff00;
|
|
}
|
|
.links {
|
|
margin-top: 30px;
|
|
}
|
|
.links h3 {
|
|
font-size: 1.3rem;
|
|
margin-bottom: 15px;
|
|
color: #ffffff;
|
|
}
|
|
.links ul {
|
|
list-style: none;
|
|
}
|
|
.links li {
|
|
margin-bottom: 8px;
|
|
}
|
|
.links a {
|
|
color: #cccccc;
|
|
text-decoration: none;
|
|
font-size: 1rem;
|
|
transition: color 0.3s ease;
|
|
}
|
|
.links a:hover {
|
|
color: #ffffff;
|
|
}
|
|
.links a:before {
|
|
content: "→ ";
|
|
margin-right: 8px;
|
|
}
|
|
.status-badge {
|
|
display: inline-block;
|
|
padding: 4px 12px;
|
|
background: #1a4d1a;
|
|
color: #4ade80;
|
|
border-radius: 16px;
|
|
font-size: 0.8rem;
|
|
font-weight: 500;
|
|
margin-bottom: 20px;
|
|
}
|
|
.footer {
|
|
text-align: center;
|
|
padding: 40px 0;
|
|
border-top: 1px solid #333;
|
|
margin-top: 80px;
|
|
color: #888;
|
|
}
|
|
@media (max-width: 768px) {
|
|
.hero h1 {
|
|
font-size: 2.5rem;
|
|
}
|
|
.hero p {
|
|
font-size: 1.1rem;
|
|
}
|
|
.buttons {
|
|
flex-direction: column;
|
|
align-items: center;
|
|
}
|
|
.btn {
|
|
width: 200px;
|
|
}
|
|
.section h2 {
|
|
font-size: 1.8rem;
|
|
}
|
|
.features {
|
|
grid-template-columns: 1fr;
|
|
}
|
|
.feature-grid {
|
|
grid-template-columns: 1fr;
|
|
}
|
|
.install-section,
|
|
.feature-list {
|
|
padding: 20px;
|
|
}
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div class="container">
|
|
<div class="hero">
|
|
<div class="status-badge">✨ Looking for feedback</div>
|
|
<h1>n34</h1>
|
|
<p>
|
|
n34 is an open source command-line interface (CLI) tool for
|
|
sending and receiving Git issues, patches and comments over the
|
|
Nostr protocol. It supports creating, replying to, and managing
|
|
issues and patches, making Git collaboration decentralized and
|
|
censorship-resistant.
|
|
</p>
|
|
<div class="buttons">
|
|
<a href="https://n34.dev/commands.html" class="btn">Documentation</a>
|
|
<a href="https://git.4rs.nl/awiteb/n34.git" class="btn">Git Repository</a>
|
|
</div>
|
|
</div>
|
|
<div class="section">
|
|
<h2>Key Features</h2>
|
|
<div class="features">
|
|
<div class="feature">
|
|
<h3><span class="feature-icon">🔄</span>Complete Git Workflow</h3>
|
|
<p>Handle the full development lifecycle with patches, issues, replies, and status tracking, all through the decentralized Nostr protocol.</p>
|
|
</div>
|
|
<div class="feature">
|
|
<h3><span class="feature-icon">🔗</span><a href="https://github.com/nostr-protocol/nips/blob/master/34.md" target="_blank" rel="noreferrer">NIP-34</a> Compliant</h3>
|
|
<p>Fully implements the <a href="https://github.com/nostr-protocol/nips/blob/master/34.md" target="_blank" rel="noreferrer">NIP-34</a> specification for Git repositories on Nostr, ensuring compatibility with the decentralized ecosystem.</p>
|
|
</div>
|
|
<div class="feature">
|
|
<h3><span class="feature-icon">🛠️</span>Developer Friendly</h3>
|
|
<p>Intuitive CLI interface designed for developers who want to integrate Git workflows with Nostr seamlessly.</p>
|
|
</div>
|
|
<div class="feature">
|
|
<h3><span class="feature-icon">🔐</span>Self-Sovereign</h3>
|
|
<p>No accounts, no passwords, no centralized servers. You control your identity and data through cryptographic keys.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="feature-list">
|
|
<h2>Feature Roadmap</h2>
|
|
<p style="text-align: center; margin-bottom: 30px; color: #cccccc;">Current implementation status and upcoming features</p>
|
|
<div class="feature-grid">
|
|
<div class="feature-column">
|
|
<ul>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Repository announcements</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Repository state announcements</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Patches (Send, fetch and list)</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Issues (Send, view and list)</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Replies</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Issues and patches status</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Pull requests (<a href="https://github.com/nostr-protocol/nips/pull/1966" target="_blank" rel="noreferrer">nostr-protocol/nips#1966</a>)</span>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="feature-column">
|
|
<ul>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Gossip Model (<a href="https://github.com/nostr-protocol/nips/blob/master/65.md" target="_blank" rel="noreferrer">NIP-65</a>)</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Proof of Work (<a href="https://github.com/nostr-protocol/nips/blob/master/13.md" target="_blank" rel="noreferrer">NIP-13</a>)</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">nostr: URI scheme (<a href="https://github.com/nostr-protocol/nips/blob/master/21.md" target="_blank" rel="noreferrer">NIP-21</a>)</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Signing using bunker (<a href="https://github.com/nostr-protocol/nips/blob/master/46.md" target="_blank" rel="noreferrer">NIP-46</a>)</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Signing using <a href="https://github.com/nostr-protocol/nips/blob/master/07.md" target="_blank" rel="noreferrer">NIP-07</a> proxy (<a href="https://crates.io/crates/nostr-browser-signer-proxy" target="_blank" rel="noreferrer">nostr-browser-signer-proxy</a>)</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">Secret key keyring</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check pending"></span>
|
|
<span class="feature-text pending">Code Snippets (<a href="https://github.com/nostr-protocol/nips/blob/master/C0.md" target="_blank" rel="noreferrer">NIP-C0</a>)</span>
|
|
</li>
|
|
<li>
|
|
<span class="feature-check completed"></span>
|
|
<span class="feature-text">In device relays and repos bookmark</span>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="install-section">
|
|
<h2>Quick Start</h2>
|
|
<p style="text-align: center; margin-bottom: 20px; color: #cccccc;">Get started with n34 in seconds</p>
|
|
<div class="code-block">
|
|
<p>cargo install n34</p>
|
|
<span># The execautable will be in ~/.cargo/bin/n34</span>
|
|
</div>
|
|
<p style="text-align: center; margin: 20px 0; color: #888;">or</p>
|
|
<div class="code-block">
|
|
<p>git clone https://git.4rs.nl/awiteb/n34.git</p>
|
|
<p>cd n34 && cargo build --release</p>
|
|
<span># The execautable will be in target/release/n34</span>
|
|
</div>
|
|
<p style="text-align: center; margin: 20px 0; color: #888;">NixOS (Version 0.4.0 or later)</p>
|
|
<div class="code-block">
|
|
<p>git clone https://git.4rs.nl/awiteb/n34.git</p>
|
|
<p>cd n34 && nix build</p>
|
|
<span># The execautable will be in result/bin/n34</span>
|
|
</div>
|
|
<p style="text-align: center; margin: 20px 0; color: #888;">home-manager</p>
|
|
<p style="text-align: center; margin-bottom: 20px; color: #cccccc;">Add this to your <code>flake.nix</code> inputs
|
|
<br>
|
|
Specify the version you want to install, or remove <code>?ref</code> for the unreleased version. You can also use any mirror; it doesn't have to be <code>git.4rs.nl</code>
|
|
</p>
|
|
<div class="code-block">
|
|
<pre>
|
|
inputs = {
|
|
n34.url = "git+https://git.4rs.nl/awiteb/n34.git?ref=refs/tags/vx.y.x";
|
|
};</pre>
|
|
</div>
|
|
<p style="text-align: center; margin-bottom: 20px; color: #cccccc;">And this in your home packages</p>
|
|
<div class="code-block">
|
|
<pre>packages = [ inputs.n34.packages."${pkgs.system}".default ];</pre>
|
|
</div>
|
|
<p style="text-align: center; margin-top: 20px; color: #cccccc;">Once installed, run <code style="background: #333; padding: 2px 6px; border-radius: 4px;">n34 --help</code> to see available commands.</p>
|
|
</div>
|
|
<div class="section">
|
|
<h2>Why Nostr?</h2>
|
|
<p>
|
|
Nostr is fundamentally different from traditional platforms because it's not an application or service, it's a decentralized protocol. This means any tool or app can integrate with it, enabling open, permissionless collaboration
|
|
without relying on centralized gatekeepers. Unlike proprietary systems, Nostr doesn't require emails, passwords, or accounts. You interact directly through relays, whether you self-host your own or use public ones, ensuring no
|
|
single point of failure or control.
|
|
</p>
|
|
<p>
|
|
What makes Nostr uniquely resilient is its design, the protocol itself is just a set of rules, not a company or product that can disappear. Your Git issues, patches, and comments persist as long as relays choose to store them,
|
|
immune to the whims of corporate shutdowns or policy changes. Nostr is infrastructure in its purest form, an idea that outlives any temporary implementation. n34 taps into a future-proof foundation for decentralized collaboration.
|
|
</p>
|
|
<div class="links">
|
|
<h3>More about Nostr</h3>
|
|
<ul>
|
|
<li><a href="https://nostr.com">nostr.com</a></li>
|
|
<li><a href="https://nostr.org">nostr.org</a></li>
|
|
<li><a href="https://nostr.how/en/what-is-nostr">nostr.how/en/what-is-nostr</a></li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="footer">
|
|
<p>Built with ❤️ for the decentralized future</p>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|