first commit
This commit is contained in:
+544
@@ -0,0 +1,544 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>claudaris</title>
|
||||
<style>
|
||||
:root {
|
||||
--bg: #0d0e1a;
|
||||
--bg-panel: #131426;
|
||||
--bg-panel-2: #1a1b2e;
|
||||
--border: #2a2c4a;
|
||||
--purple: #bb9af7;
|
||||
--blue: #7aa2f7;
|
||||
--cyan: #7dcfff;
|
||||
--green: #9ece6a;
|
||||
--yellow: #e0af68;
|
||||
--pink: #f7768e;
|
||||
--text: #c0caf5;
|
||||
--text-dim: #6b7089;
|
||||
--mono: "SF Mono", "Fira Code", "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
|
||||
}
|
||||
|
||||
* { box-sizing: border-box; }
|
||||
|
||||
html, body {
|
||||
margin: 0;
|
||||
padding: 0;
|
||||
background: var(--bg);
|
||||
color: var(--text);
|
||||
font-family: var(--mono);
|
||||
overflow-x: hidden;
|
||||
}
|
||||
|
||||
body {
|
||||
background-image:
|
||||
linear-gradient(rgba(187,154,247,0.035) 1px, transparent 1px),
|
||||
linear-gradient(90deg, rgba(187,154,247,0.035) 1px, transparent 1px);
|
||||
background-size: 40px 40px;
|
||||
min-height: 100vh;
|
||||
}
|
||||
|
||||
::selection { background: var(--purple); color: var(--bg); }
|
||||
|
||||
a { color: var(--cyan); text-decoration: none; }
|
||||
a:hover { text-decoration: underline; }
|
||||
|
||||
/* scanline flicker overlay */
|
||||
.scanlines {
|
||||
pointer-events: none;
|
||||
position: fixed;
|
||||
inset: 0;
|
||||
z-index: 50;
|
||||
background: repeating-linear-gradient(
|
||||
to bottom,
|
||||
rgba(255,255,255,0.015) 0px,
|
||||
rgba(255,255,255,0.015) 1px,
|
||||
transparent 1px,
|
||||
transparent 3px
|
||||
);
|
||||
mix-blend-mode: overlay;
|
||||
}
|
||||
|
||||
.wrap {
|
||||
max-width: 900px;
|
||||
margin: 0 auto;
|
||||
padding: 48px 24px 96px;
|
||||
position: relative;
|
||||
}
|
||||
|
||||
/* Header */
|
||||
header {
|
||||
border: 1px solid var(--border);
|
||||
background: linear-gradient(180deg, var(--bg-panel), var(--bg));
|
||||
border-radius: 8px;
|
||||
padding: 28px 32px;
|
||||
margin-bottom: 28px;
|
||||
position: relative;
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
header::before {
|
||||
content: "";
|
||||
position: absolute;
|
||||
top: 0; left: 0; right: 0;
|
||||
height: 2px;
|
||||
background: linear-gradient(90deg, transparent, var(--purple), var(--cyan), var(--purple), transparent);
|
||||
animation: scan 4s linear infinite;
|
||||
}
|
||||
|
||||
@keyframes scan {
|
||||
0% { transform: translateX(-100%); }
|
||||
100% { transform: translateX(100%); }
|
||||
}
|
||||
|
||||
.glitch-title {
|
||||
font-size: clamp(2rem, 6vw, 3.2rem);
|
||||
font-weight: 800;
|
||||
letter-spacing: 2px;
|
||||
margin: 0;
|
||||
color: var(--purple);
|
||||
text-shadow:
|
||||
0 0 8px rgba(187,154,247,0.6),
|
||||
0 0 24px rgba(187,154,247,0.25);
|
||||
position: relative;
|
||||
display: inline-block;
|
||||
}
|
||||
|
||||
.glitch-title::after {
|
||||
content: attr(data-text);
|
||||
position: absolute;
|
||||
left: 2px;
|
||||
top: 0;
|
||||
color: var(--cyan);
|
||||
opacity: 0.5;
|
||||
clip-path: inset(0 0 55% 0);
|
||||
animation: glitch 3.2s infinite steps(1);
|
||||
}
|
||||
|
||||
@keyframes glitch {
|
||||
0%, 92%, 100% { clip-path: inset(0 0 100% 0); transform: translate(0,0); }
|
||||
93% { clip-path: inset(10% 0 60% 0); transform: translate(-2px,1px); }
|
||||
95% { clip-path: inset(50% 0 10% 0); transform: translate(2px,-1px); }
|
||||
97% { clip-path: inset(20% 0 40% 0); transform: translate(-1px,0); }
|
||||
}
|
||||
|
||||
.subtitle {
|
||||
color: var(--text-dim);
|
||||
margin-top: 10px;
|
||||
font-size: 0.95rem;
|
||||
}
|
||||
|
||||
.subtitle .accent { color: var(--green); }
|
||||
.subtitle .accent2 { color: var(--yellow); }
|
||||
|
||||
.tags {
|
||||
margin-top: 18px;
|
||||
display: flex;
|
||||
gap: 8px;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.tag {
|
||||
font-size: 0.72rem;
|
||||
padding: 3px 10px;
|
||||
border: 1px solid var(--border);
|
||||
border-radius: 999px;
|
||||
color: var(--text-dim);
|
||||
background: rgba(255,255,255,0.02);
|
||||
letter-spacing: 0.5px;
|
||||
}
|
||||
|
||||
/* Nav */
|
||||
nav {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 10px;
|
||||
margin-bottom: 32px;
|
||||
}
|
||||
|
||||
nav a {
|
||||
color: var(--text-dim);
|
||||
border: 1px solid var(--border);
|
||||
padding: 6px 14px;
|
||||
border-radius: 6px;
|
||||
font-size: 0.8rem;
|
||||
transition: all 0.15s ease;
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
nav a:hover {
|
||||
color: var(--bg);
|
||||
background: var(--purple);
|
||||
border-color: var(--purple);
|
||||
box-shadow: 0 0 14px rgba(187,154,247,0.5);
|
||||
}
|
||||
|
||||
/* Section panels */
|
||||
section {
|
||||
border: 1px solid var(--border);
|
||||
background: var(--bg-panel);
|
||||
border-radius: 8px;
|
||||
padding: 26px 30px;
|
||||
margin-bottom: 20px;
|
||||
scroll-margin-top: 20px;
|
||||
position: relative;
|
||||
}
|
||||
|
||||
section h2 {
|
||||
margin: 0 0 14px;
|
||||
font-size: 1.05rem;
|
||||
letter-spacing: 1px;
|
||||
text-transform: uppercase;
|
||||
color: var(--blue);
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 10px;
|
||||
}
|
||||
|
||||
section h2::before {
|
||||
content: "";
|
||||
width: 8px;
|
||||
height: 8px;
|
||||
background: var(--cyan);
|
||||
box-shadow: 0 0 8px var(--cyan);
|
||||
border-radius: 1px;
|
||||
transform: rotate(45deg);
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
section p {
|
||||
line-height: 1.7;
|
||||
color: var(--text);
|
||||
font-size: 0.92rem;
|
||||
}
|
||||
|
||||
section p.dim, li.dim { color: var(--text-dim); }
|
||||
|
||||
code, .kbd {
|
||||
font-family: var(--mono);
|
||||
background: rgba(122,162,247,0.1);
|
||||
color: var(--cyan);
|
||||
padding: 1px 6px;
|
||||
border-radius: 4px;
|
||||
border: 1px solid rgba(122,162,247,0.2);
|
||||
font-size: 0.86em;
|
||||
}
|
||||
|
||||
pre {
|
||||
background: #0a0b16;
|
||||
border: 1px solid var(--border);
|
||||
border-left: 3px solid var(--purple);
|
||||
border-radius: 6px;
|
||||
padding: 16px 18px;
|
||||
overflow-x: auto;
|
||||
margin: 14px 0;
|
||||
position: relative;
|
||||
}
|
||||
|
||||
pre::before {
|
||||
content: "$";
|
||||
color: var(--green);
|
||||
margin-right: 10px;
|
||||
opacity: 0.7;
|
||||
}
|
||||
|
||||
pre code {
|
||||
background: none;
|
||||
border: none;
|
||||
padding: 0;
|
||||
color: var(--green);
|
||||
font-size: 0.9rem;
|
||||
}
|
||||
|
||||
/* Command grid */
|
||||
.cmd-grid {
|
||||
display: grid;
|
||||
grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
|
||||
gap: 12px;
|
||||
margin-top: 8px;
|
||||
}
|
||||
|
||||
.cmd-card {
|
||||
border: 1px solid var(--border);
|
||||
background: var(--bg-panel-2);
|
||||
border-radius: 6px;
|
||||
padding: 14px 16px;
|
||||
transition: border-color 0.2s ease, transform 0.2s ease;
|
||||
}
|
||||
|
||||
.cmd-card:hover {
|
||||
border-color: var(--purple);
|
||||
transform: translateY(-2px);
|
||||
}
|
||||
|
||||
.cmd-card .cmd {
|
||||
color: var(--pink);
|
||||
font-weight: 700;
|
||||
font-size: 0.95rem;
|
||||
}
|
||||
|
||||
.cmd-card .alias {
|
||||
color: var(--text-dim);
|
||||
font-size: 0.75rem;
|
||||
margin-left: 6px;
|
||||
}
|
||||
|
||||
.cmd-card .desc {
|
||||
color: var(--text-dim);
|
||||
font-size: 0.82rem;
|
||||
margin-top: 6px;
|
||||
line-height: 1.5;
|
||||
}
|
||||
|
||||
/* Config table */
|
||||
table {
|
||||
width: 100%;
|
||||
border-collapse: collapse;
|
||||
margin-top: 10px;
|
||||
font-size: 0.86rem;
|
||||
}
|
||||
|
||||
th {
|
||||
text-align: left;
|
||||
color: var(--yellow);
|
||||
font-weight: 600;
|
||||
padding: 8px 10px;
|
||||
border-bottom: 1px solid var(--border);
|
||||
font-size: 0.78rem;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.5px;
|
||||
}
|
||||
|
||||
td {
|
||||
padding: 10px 10px;
|
||||
border-bottom: 1px solid rgba(42,44,74,0.5);
|
||||
vertical-align: top;
|
||||
color: var(--text);
|
||||
}
|
||||
|
||||
tr:last-child td { border-bottom: none; }
|
||||
|
||||
td.name { color: var(--green); white-space: nowrap; }
|
||||
td.default { color: var(--text-dim); }
|
||||
|
||||
ul.check {
|
||||
list-style: none;
|
||||
padding: 0;
|
||||
margin: 8px 0 0;
|
||||
}
|
||||
|
||||
ul.check li {
|
||||
padding: 6px 0 6px 24px;
|
||||
position: relative;
|
||||
font-size: 0.9rem;
|
||||
line-height: 1.6;
|
||||
color: var(--text);
|
||||
}
|
||||
|
||||
ul.check li::before {
|
||||
content: "▸";
|
||||
position: absolute;
|
||||
left: 0;
|
||||
color: var(--purple);
|
||||
}
|
||||
|
||||
.note {
|
||||
border-left: 3px solid var(--yellow);
|
||||
background: rgba(224,175,104,0.06);
|
||||
padding: 10px 16px;
|
||||
border-radius: 0 6px 6px 0;
|
||||
font-size: 0.85rem;
|
||||
color: var(--text-dim);
|
||||
margin-top: 14px;
|
||||
}
|
||||
.note strong { color: var(--yellow); }
|
||||
|
||||
footer {
|
||||
text-align: center;
|
||||
color: var(--text-dim);
|
||||
font-size: 0.78rem;
|
||||
margin-top: 40px;
|
||||
padding-top: 24px;
|
||||
border-top: 1px solid var(--border);
|
||||
}
|
||||
|
||||
footer .blink {
|
||||
animation: blink 1.4s steps(1) infinite;
|
||||
color: var(--green);
|
||||
}
|
||||
|
||||
@keyframes blink {
|
||||
50% { opacity: 0; }
|
||||
}
|
||||
|
||||
@media (max-width: 600px) {
|
||||
section { padding: 20px 18px; }
|
||||
header { padding: 22px 20px; }
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div class="scanlines"></div>
|
||||
<div class="wrap">
|
||||
|
||||
<header>
|
||||
<h1 class="glitch-title" data-text="CLAUDARIS">CLAUDARIS</h1>
|
||||
<div class="subtitle">
|
||||
/klaw-<span class="accent">DAR</span>-iss/ — a moveable docker container for
|
||||
<span class="accent2">Claude Code</span>. using Arch btw.
|
||||
</div>
|
||||
<div class="tags">
|
||||
<span class="tag">ARCHLINUX</span>
|
||||
<span class="tag">TMUX</span>
|
||||
<span class="tag">SELF-HOSTED</span>
|
||||
<span class="tag">NO-RESTART-POLICY</span>
|
||||
</div>
|
||||
</header>
|
||||
|
||||
<nav>
|
||||
<a href="#configure">01 · configure</a>
|
||||
<a href="#commands">02 · commands</a>
|
||||
<a href="#ssh">03 · ssh</a>
|
||||
<a href="#internals">04 · internals</a>
|
||||
<a href="#structure">05 · repo</a>
|
||||
</nav>
|
||||
|
||||
<section id="configure">
|
||||
<h2>Configure</h2>
|
||||
<p>
|
||||
Run the interactive wizard — press enter at any prompt to keep the
|
||||
current/default value:
|
||||
</p>
|
||||
<pre><code>./claudaris config</code></pre>
|
||||
<p>
|
||||
It writes your answers to <code>.env</code> (gitignored — every user
|
||||
keeps their own), which every other command sources. Set
|
||||
<code>NAME</code> to something unique to you (e.g. <code>chris-claude</code>)
|
||||
if more than one person is running a container from this same repo
|
||||
checkout. Re-run <code>config</code> / <code>configure</code> any time
|
||||
to update it.
|
||||
</p>
|
||||
<table>
|
||||
<tr><th>variable</th><th>purpose</th><th>default</th></tr>
|
||||
<tr>
|
||||
<td class="name">NAME</td>
|
||||
<td>Image name, container name, and hostname inside the container (shows up as <code>root@$NAME</code> in the prompt).</td>
|
||||
<td class="default">claudaris</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="name">DATA_DIR</td>
|
||||
<td>Host directory for volume mount data — bashrc, aliases, Claude auth, ssh keys.</td>
|
||||
<td class="default">/data/$NAME</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="name">WORKSPACE_DIR</td>
|
||||
<td>Host directory mounted as <code>/projects</code> inside the container.</td>
|
||||
<td class="default">/home/$USER/projects</td>
|
||||
</tr>
|
||||
</table>
|
||||
</section>
|
||||
|
||||
<section id="commands">
|
||||
<h2>Commands</h2>
|
||||
<p class="dim">Everything runs through the single <code>claudaris</code> entry point.</p>
|
||||
|
||||
<div class="cmd-grid">
|
||||
<div class="cmd-card">
|
||||
<div><span class="cmd">config</span><span class="alias">configure</span></div>
|
||||
<div class="desc">Interactive wizard — writes <code>NAME</code>, <code>DATA_DIR</code>, <code>WORKSPACE_DIR</code> to <code>.env</code>.</div>
|
||||
<pre><code>./claudaris config</code></pre>
|
||||
</div>
|
||||
<div class="cmd-card">
|
||||
<div><span class="cmd">build</span></div>
|
||||
<div class="desc">Builds the image (always <code>--no-cache --pull</code>, so it picks up the latest Claude Code release).</div>
|
||||
<pre><code>sudo ./claudaris build</code></pre>
|
||||
</div>
|
||||
<div class="cmd-card">
|
||||
<div><span class="cmd">start</span></div>
|
||||
<div class="desc">Creates or restarts the container with all volumes wired up.</div>
|
||||
<pre><code>sudo ./claudaris start</code></pre>
|
||||
</div>
|
||||
<div class="cmd-card">
|
||||
<div><span class="cmd">connect</span></div>
|
||||
<div class="desc">Starts the container if needed, then attaches your tmux session.</div>
|
||||
<pre><code>sudo ./claudaris connect</code></pre>
|
||||
</div>
|
||||
<div class="cmd-card">
|
||||
<div><span class="cmd">remove</span><span class="alias">stop · rm</span></div>
|
||||
<div class="desc">Stops and removes the container so the next <code>start</code> recreates it fresh.</div>
|
||||
<pre><code>sudo ./claudaris remove</code></pre>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section id="ssh">
|
||||
<h2>Optional: SSH access to other nodes</h2>
|
||||
<p>
|
||||
To let the container SSH out to other machines, create
|
||||
<code>$DATA_DIR/ssh</code> on the host and populate it with keys/config
|
||||
<em>before</em> running <code>./claudaris start</code>. If present, it's
|
||||
bind-mounted read-only to <code>/root/.ssh</code>.
|
||||
</p>
|
||||
<div class="note"><strong>off by default</strong> — nothing is mounted unless the directory exists.</div>
|
||||
</section>
|
||||
|
||||
<section id="internals">
|
||||
<h2>Internals</h2>
|
||||
|
||||
<p><strong style="color:var(--green)">Persistent login.</strong>
|
||||
Claude Code is installed at build time under <code>/root</code>, so a
|
||||
rebuild always picks up the latest release. Two files are bind-mounted
|
||||
individually to survive that: <code>~/.claude/.credentials.json</code>
|
||||
(the OAuth token) and <code>~/.claude.json</code> (account/onboarding
|
||||
state — Claude Code checks this too, so persisting the token alone
|
||||
isn't enough to avoid a re-login prompt after a rebuild).
|
||||
<code>./claudaris start</code> seeds both from empty on the host the
|
||||
first time it runs.
|
||||
</p>
|
||||
|
||||
<p><strong style="color:var(--green)">Self-stopping.</strong>
|
||||
The container stops itself once its tmux session ends (any shell exit
|
||||
— Ctrl+D, <code>exit</code>, crash) instead of running forever, and
|
||||
there's no Docker restart policy — <code>connect</code> and
|
||||
<code>start</code> both bring it back up automatically if you find it
|
||||
stopped.
|
||||
</p>
|
||||
|
||||
<p><strong style="color:var(--green)">Dotfiles.</strong>
|
||||
<code>.bashrc</code> and <code>bash_aliases</code> are both bind-mounted
|
||||
as single files so they can be tweaked per-host (e.g. a coworker
|
||||
importing their own aliases) without a rebuild.
|
||||
<code>./claudaris start</code> seeds them from <code>files/bashrc</code>
|
||||
and <code>files/bash_aliases</code> the first time it runs, without
|
||||
overwriting later edits. Anything that needs to survive regardless
|
||||
(PATH, zoxide, git identity) lives in <code>/etc/...</code> inside the
|
||||
image instead of under <code>/root</code>.
|
||||
</p>
|
||||
|
||||
<p><strong style="color:var(--green)">Hostname.</strong>
|
||||
The container is started with <code>--hostname "$NAME"</code>, so the
|
||||
prompt reads <code>root@claudaris</code> (or whatever you set
|
||||
<code>NAME</code> to) instead of a random container ID.
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<section id="structure">
|
||||
<h2>Repo layout</h2>
|
||||
<ul class="check">
|
||||
<li><code>claudaris</code> — the entry point: build / start / connect / remove / help.</li>
|
||||
<li><code>Dockerfile</code> — Arch base image, dotfiles, Claude Code install, entrypoint.</li>
|
||||
<li><code>.env</code> — written by <code>claudaris config</code>, per-user, gitignored.</li>
|
||||
<li><code>files/</code> — <code>bashrc</code>, <code>bash_aliases</code>, <code>entrypoint.sh</code>, <code>tmux</code> wrapper, <code>tmux.conf</code>.</li>
|
||||
<li><code>AGENTS.md</code> — deep-dive notes for anyone (human or agent) hacking on this repo.</li>
|
||||
</ul>
|
||||
</section>
|
||||
|
||||
<footer>
|
||||
claudaris <span class="blink">█</span> moveable · self-hosted · always running the latest Claude Code
|
||||
</footer>
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user