Sandbox
Sign in
@paleo/alignfirst
Tools#Claude Code#Codex#Coding#Testing#Docs

CLI tools, skills, and workspaces for coding agents

AlignFirst bundles several reusable pieces for agent-assisted software work. The main pieces are a CLI for AlignFirst workflows, skills that expose those workflows in Claude Code and Codex, a docmap for agent-discoverable docs, and a workspace package for running side-by-side worktrees. It also includes a Dockerized test harness and an AI teammate package built on OpenClaw.

86 stars•7 forks•TypeScript•Updated 7d ago
Who it's for

Builders who want their agent workflow, docs, and local environments to be more structured and reusable.

What it delivers

You can add a shared set of agent workflows, local workspaces, and docs navigation instead of stitching these pieces together yourself.

What it does

AlignFirst CLI

`packages/alignfirst` provides the `alignfirst` command and the main workflows.

Agent skills

`skills/` and `skills-lock.json` package nine skills, including commands like `/alspec` in Claude Code and `$alspec` in Codex.

Docmap

`packages/docmap` adds a lightweight table of contents so agents can navigate documentation files.

Workspace manager

`packages/workspace` runs multiple development environments side by side with git worktrees.

OpenClaw regression tests

`alignfirst-developer-tests/` and the `packages/openclaw-*` mocks provide a Dockerized harness for channel-based testing.

Developer teammate package

`alignfirst-developer.md` and `packages/alignfirst-developer-openclaw-plugin` describe and package the AlignFirst Developer agent.

How to get it

  1. 1Our alignfirst-setup-guide skill can help to install these tools. Temporarily install…
    npx skills add https://github.com/paleo/alignfirst --skill alignfirst-setup-guide
  2. 2Then, in your project, ask your agent
    Use your alignfirst-setup-guide skill. What can I set up in this project?

README

AlignFirst monorepo

Companion products for AI-assisted software work. They can be used independently.

alignfirst CLI

The alignfirst CLI provides the AlignFirst workflows. See the CLI README for installation and usage.

Agent skills

Nine Agent Skill stubs expose the CLI through commands such as /alspec in Claude Code and $alspec in Codex. See the Agent skills section.

Docmap - Agent-discoverable documentation

@paleo/docmap is a lightweight table of contents that lets agents navigate documentation files. This way we have one set of docs, shared by humans and AI agents. See packages/docmap/README.md.

Workspaces - Local environments with worktrees

@paleo/workspace runs multiple dev environments side by side using git worktrees. See packages/workspace/README.md.

OpenClaw Test toolkit

@paleo/openclaw-test and three companion channel packages are a Dockerised regression-test harness that drives OpenClaw through synthetic Discord and Slack channels. See packages/openclaw-test/README.md.

AlignFirst Developer

AlignFirst Developer is an AI teammate for software work, currently packaged on OpenClaw. See alignfirst-developer.md.

@paleo/alignfirst-developer-openclaw-plugin supplies its OpenClaw capabilities under plugin ID alignfirst-developer. Its first capability, thread handoff, durably activates the ordinary thread session after confirmed native starter delivery.

Setup with your agent

Our alignfirst-setup-guide skill can help to install these tools. Temporarily install the skill (globally or locally):

npx skills add https://github.com/paleo/alignfirst --skill alignfirst-setup-guide

Then, in your project, ask your agent:

Use your alignfirst-setup-guide skill. What can I set up in this project?

At the end, feel free to uninstall the skill. It won't be used by your project anymore.

Contribute

After a fresh clone:

npm install
npm run build --workspace @paleo/workspace
npm run workspace -- setup

The everyday workflow is in DEVELOPERS.md.

Files in the repo

Repository payload•24 top-level entries
  • .agents
  • .changeset
  • .claude
  • .github
  • .vscode
  • alignfirst-developer-tests
  • docs
  • packages
  • scripts
  • skills
  • .alignfirst.json
  • .gitignore
  • .nvmrc
  • AGENTS.md
  • alignfirst-developer.md
  • alignfirst-skills.md
  • biome.json
  • CLAUDE.md
  • DEVELOPERS.md
  • LICENSE
  • package-lock.json
  • package.json
  • README.md
  • skills-lock.json

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More tools

JuliusBrussee/
caveman
JuliusBrussee/cavemanTools

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

105k
1 add
MemPalace/
mempalace
MemPalace/mempalaceTools

The best-benchmarked open-source AI memory system. And it's free.

59k
stablyai/
orca
stablyai/orcaTools

Orca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

66k
farion1231/cc-switchTools

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

132k
diegosouzapw/OmniRouteTools

Never stop coding. Free MIT AI gateway: one endpoint, 352 providers (150+ free), 1200+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550+ contributors

64k
headroomlabs-ai/
headroom
headroomlabs-ai/headroomTools

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

71k