Skip to content

puq v1.0.0

Choose a tag to compare

View all tags
@aliyilmazco aliyilmazco released this 02 Oct 08:05
· 4 commits to main since this release
v1.0.0
4c107ca

The first release of puq code: a coding agent that lives in your terminal, run as puq.

Install

curl -fsSL https://github.com/puq-ai/code/releases/download/channels/install.sh | sh

Then run puq in any project and sign in with /login puq (a puq.ai token). Runs on macOS
(arm64, x64) and Linux (x64, arm64, glibc).

What's in 1.0.0

  • Works in your codebase: reads, searches and edits files, runs shell commands, uses language
    servers (LSP) for definitions, references and diagnostics, connects MCP servers, and runs
    subagents in parallel.
  • Spends less per turn: the optimizer ranks code_search hits and trims tool output;
    /optimizer shows what was pruned and saved, and the turn_cost status-bar segment shows each
    turn's cost.
  • Modes on Shift+Tab: Manual → Auto-edit → Plan → Yolo; the thinking level cycles on Ctrl+N.
    tools.approvalMode: "auto" lets the optimizer approve low-risk commands and asks you for the rest.
  • Safe to experiment: /undo and /redo rewind code and conversation together from a snapshot
    taken before every prompt, and shell commands can run in an OS-level sandbox (sandbox-exec on
    macOS, bubblewrap on Linux; bash.sandbox).
  • Claude Code-compatible hooks: hooks in .claude/settings.json and executables in
    .claude/hooks/ work as-is; project hooks ask for approval the first time they are seen.
  • Formats on write with the project's own formatter (prettier, biome, gofmt, rustfmt, ruff, black).
  • Web search through puq with your /login puq key.
  • puq media: image, music, speech and video generation and transcription (/image, /voice,
    /music, /video, /transcribe), and /live voice conversations.
  • Scriptable: puq -p --output-schema returns JSON that matches a schema, and
    puq github install adds a GitHub Actions workflow triggered by a /puq comment.
  • /init writes or updates AGENTS.md for your project.

Updates

puq checks its channel on launch and every 6 hours, verifies the SHA-256 and switches over on the
next start; puq update does it by hand. stable (the default) gets versions after about a week
on latest; switch with puq config set update.channel latest.

License

MIT. puq code is derived from oh-my-pi (MIT);
puq --license shows the copyright lines and third-party notices.

Assets 8
Loading