octo-agent 0.11.2

data/.clacky/skills/gem-release/scripts/release.sh

@@ -0,0 +1,304 @@
+#!/bin/bash
+# release.sh — octo gem release automation
+#
+# Usage:
+#   bash release.sh <version> [--prerelease] [--update-latest]
+#
+# Examples:
+#   bash release.sh 1.0.6                           # stable release
+#   bash release.sh 1.0.6 --dry-run                 # preview without executing
+#   bash release.sh 2.0.0.beta.1 --prerelease       # pre-release, skip latest.txt
+#   bash release.sh 2.0.0.rc1 --prerelease --update-latest  # pre-release, update latest.txt
+#
+# Prerequisites:
+#   - gh CLI installed and authenticated
+#   - coscli installed at /usr/local/bin/coscli with ~/.cos.yaml
+#   - RubyGems credentials configured (gem push)
+
+set -euo pipefail
+
+# ── Colors ──────────────────────────────────────────────────────────────
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+info()    { echo -e "${BLUE}ℹ${NC}  $1"; }
+success() { echo -e "${GREEN}✓${NC}  $1"; }
+warn()    { echo -e "${YELLOW}⚠${NC}  $1"; }
+error()   { echo -e "${RED}✗${NC}  $1" >&2; }
+step()    { echo -e "\n${CYAN}▶ Step $1:${NC} $2\n"; }
+die()     { error "$1"; exit 1; }
+
+# ── Parse args ──────────────────────────────────────────────────────────
+VERSION=""
+PRERELEASE=false
+UPDATE_LATEST=true
+DRY_RUN=false
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --prerelease)    PRERELEASE=true; UPDATE_LATEST=false ;;
+        --update-latest) UPDATE_LATEST=true ;;
+        --dry-run)       DRY_RUN=true ;;
+        --help|-h)
+            echo "Usage: bash release.sh <version> [--prerelease] [--update-latest] [--dry-run]"
+            exit 0
+            ;;
+        -*)              die "Unknown option: $1" ;;
+        *)               VERSION="$1" ;;
+    esac
+    shift
+done
+
+[[ -z "$VERSION" ]] && die "Version argument required. Usage: bash release.sh <version>"
+
+# ── Resolve paths ───────────────────────────────────────────────────────
+REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)" || die "Not inside a git repository"
+cd "$REPO_ROOT"
+
+VERSION_FILE="lib/octo/version.rb"
+GEMSPEC="octo.gemspec"
+CHANGELOG="CHANGELOG.md"
+GEM_FILE="octo-${VERSION}.gem"
+OSS_BUCKET="cos://octoai-1258723534"
+
+[[ -f "$VERSION_FILE" ]] || die "Version file not found: $VERSION_FILE"
+[[ -f "$GEMSPEC" ]]      || die "Gemspec not found: $GEMSPEC"
+
+CURRENT_VERSION=$(ruby -ne 'puts $1 if /VERSION\s*=\s*"([^"]+)"/' "$VERSION_FILE")
+info "Current version: ${CURRENT_VERSION}"
+info "Target version:  ${VERSION}"
+info "Pre-release:     ${PRERELEASE}"
+info "Update latest:   ${UPDATE_LATEST}"
+info "Dry run:         ${DRY_RUN}"
+echo ""
+
+if [[ "$DRY_RUN" == true ]]; then
+    warn "DRY RUN mode — no changes will be made"
+    echo ""
+fi
+
+# ── Helper: run or preview ──────────────────────────────────────────────
+run() {
+    if [[ "$DRY_RUN" == true ]]; then
+        echo -e "  ${YELLOW}[dry-run]${NC} $*"
+    else
+        "$@"
+    fi
+}
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 1: Pre-release checks
+# ════════════════════════════════════════════════════════════════════════
+step 1 "Pre-release checks"
+
+if [[ -n "$(git status --porcelain)" ]]; then
+    die "Working directory is not clean. Commit or stash changes first."
+fi
+success "Working directory is clean"
+
+BRANCH=$(git branch --show-current)
+if [[ "$BRANCH" != "main" ]]; then
+    warn "Not on main branch (currently on '${BRANCH}')"
+fi
+
+command -v gh    >/dev/null 2>&1 || die "gh CLI not found. Install with: brew install gh"
+command -v coscli >/dev/null 2>&1 || die "coscli not found. Install at /usr/local/bin/coscli"
+success "Required tools available (gh, coscli)"
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 2: Run tests
+# ════════════════════════════════════════════════════════════════════════
+step 2 "Running test suite"
+
+if [[ "$DRY_RUN" == true ]]; then
+    echo -e "  ${YELLOW}[dry-run]${NC} bundle exec rspec"
+else
+    bundle exec rspec || die "Tests failed — aborting release"
+fi
+success "All tests passed"
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 3: Bump version
+# ════════════════════════════════════════════════════════════════════════
+step 3 "Bumping version to ${VERSION}"
+
+run sed -i '' "s/VERSION = \"${CURRENT_VERSION}\"/VERSION = \"${VERSION}\"/" "$VERSION_FILE"
+
+if [[ "$DRY_RUN" != true ]]; then
+    grep -q "VERSION = \"${VERSION}\"" "$VERSION_FILE" || die "Version bump failed"
+fi
+success "Updated ${VERSION_FILE}"
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 4: Update Gemfile.lock
+# ════════════════════════════════════════════════════════════════════════
+step 4 "Updating Gemfile.lock"
+
+run bundle install --quiet
+success "Gemfile.lock updated"
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 5: Commit version bump
+# ════════════════════════════════════════════════════════════════════════
+step 5 "Committing version bump"
+
+run git add "$VERSION_FILE" Gemfile.lock
+run git commit -m "chore: bump version to ${VERSION}"
+success "Version bump committed"
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 6: Push and wait for CI
+# ════════════════════════════════════════════════════════════════════════
+step 6 "Pushing to origin and checking CI"
+
+run git push origin "$BRANCH"
+success "Pushed to origin/${BRANCH}"
+
+if [[ "$DRY_RUN" != true ]]; then
+    info "Waiting for CI to complete (this may take a few minutes)..."
+    if gh run list --branch "$BRANCH" --limit 1 --json status -q '.[0].status' 2>/dev/null | grep -q "completed"; then
+        success "CI already completed"
+    else
+        gh run watch --exit-status 2>/dev/null || warn "Could not watch CI run — verify manually at GitHub Actions"
+    fi
+fi
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 7: Build gem
+# ════════════════════════════════════════════════════════════════════════
+step 7 "Building gem"
+
+run gem build "$GEMSPEC"
+
+if [[ "$DRY_RUN" != true ]]; then
+    [[ -f "$GEM_FILE" ]] || die "Gem file not found: $GEM_FILE"
+fi
+success "Built ${GEM_FILE}"
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 8: Publish to RubyGems
+# ════════════════════════════════════════════════════════════════════════
+step 8 "Publishing to RubyGems"
+
+run gem push "$GEM_FILE"
+success "Published to RubyGems"
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 9: Git tag
+# ════════════════════════════════════════════════════════════════════════
+step 9 "Creating git tag v${VERSION}"
+
+run git tag "v${VERSION}"
+run git push origin --tags
+success "Tag v${VERSION} pushed"
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 10: GitHub Release
+# ════════════════════════════════════════════════════════════════════════
+step 10 "Creating GitHub Release"
+
+RELEASE_NOTES_FILE="/tmp/release_notes_${VERSION}.md"
+
+if [[ "$DRY_RUN" != true ]]; then
+    if [[ -f "$CHANGELOG" ]]; then
+        # Extract section for this version from CHANGELOG
+        awk "/^## \\[${VERSION}\\]/{found=1; next} /^## \\[/{if(found) exit} found{print}" "$CHANGELOG" > "$RELEASE_NOTES_FILE"
+        if [[ ! -s "$RELEASE_NOTES_FILE" ]]; then
+            echo "Release v${VERSION}" > "$RELEASE_NOTES_FILE"
+            warn "No CHANGELOG entry found for ${VERSION} — using placeholder"
+        fi
+    else
+        echo "Release v${VERSION}" > "$RELEASE_NOTES_FILE"
+        warn "CHANGELOG.md not found — using placeholder"
+    fi
+fi
+
+if [[ "$PRERELEASE" == true ]]; then
+    run gh release create "v${VERSION}" \
+        --title "v${VERSION}" \
+        --notes-file "$RELEASE_NOTES_FILE" \
+        --prerelease \
+        "$GEM_FILE"
+else
+    run gh release create "v${VERSION}" \
+        --title "v${VERSION}" \
+        --notes-file "$RELEASE_NOTES_FILE" \
+        --latest \
+        "$GEM_FILE"
+fi
+success "GitHub Release created"
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 11: Upload to OSS CDN
+# ════════════════════════════════════════════════════════════════════════
+step 11 "Syncing to Tencent Cloud OSS"
+
+run coscli cp "$GEM_FILE" "${OSS_BUCKET}/octo/${GEM_FILE}"
+success "Uploaded ${GEM_FILE} to OSS"
+
+if [[ "$UPDATE_LATEST" == true ]]; then
+    if [[ "$DRY_RUN" != true ]]; then
+        echo "${VERSION}" > /tmp/latest.txt
+    fi
+    run coscli cp /tmp/latest.txt "${OSS_BUCKET}/octo/latest.txt"
+    success "Updated latest.txt → ${VERSION}"
+
+    if [[ "$DRY_RUN" != true ]]; then
+        VERIFY=$(curl -fsSL https://oss.1024code.com/octo/latest.txt 2>/dev/null || echo "FAILED")
+        if [[ "$VERIFY" == "$VERSION" ]]; then
+            success "Verified latest.txt = ${VERSION}"
+        else
+            warn "latest.txt verification returned: ${VERIFY}"
+        fi
+    fi
+else
+    info "Skipping latest.txt update (pre-release or not requested)"
+fi
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 12: Sync scripts to OSS
+# ════════════════════════════════════════════════════════════════════════
+step 12 "Rebuilding and syncing scripts to OSS"
+
+run bash scripts/build/build.sh
+
+if [[ "$DRY_RUN" != true ]]; then
+    for script in scripts/*.sh scripts/*.ps1; do
+        [[ -f "$script" ]] || continue
+        coscli cp "$script" "${OSS_BUCKET}/octo-ai/octo/main/scripts/$(basename "$script")"
+        success "Uploaded $(basename "$script")"
+    done
+else
+    echo -e "  ${YELLOW}[dry-run]${NC} Upload scripts/*.sh and scripts/*.ps1 to OSS"
+fi
+success "Scripts synced to OSS"
+
+# ════════════════════════════════════════════════════════════════════════
+# Step 13: Cleanup
+# ════════════════════════════════════════════════════════════════════════
+step 13 "Cleanup"
+
+[[ -f "$GEM_FILE" ]] && rm -f "$GEM_FILE" && info "Removed ${GEM_FILE}"
+[[ -f "$RELEASE_NOTES_FILE" ]] && rm -f "$RELEASE_NOTES_FILE"
+[[ -f "/tmp/latest.txt" ]] && rm -f /tmp/latest.txt
+
+# ════════════════════════════════════════════════════════════════════════
+# Done
+# ════════════════════════════════════════════════════════════════════════
+echo ""
+echo "╔═══════════════════════════════════════════════════════════╗"
+echo "║                                                           ║"
+echo -e "║   ${GREEN}🎉  v${VERSION} released successfully!${NC}                     ║"
+echo "║                                                           ║"
+echo "╠═══════════════════════════════════════════════════════════╣"
+echo "║                                                           ║"
+echo "║  📦 RubyGems:  rubygems.org/gems/octo              ║"
+echo "║  🏷️  GitHub:    github.com/octo-ai/octo/releases  ║"
+echo "║  ☁️  OSS CDN:   oss.1024code.com/octo/              ║"
+echo "║                                                           ║"
+echo "╚═══════════════════════════════════════════════════════════╝"
+echo ""

data/.clacky/skills/oss-upload/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: oss-upload
+description: Upload local files to Tencent COS (oss.1024code.com CDN) using coscli. Use when user wants to upload a file to CDN/OSS, or deploy static assets.
+---
+
+# OSS Upload Skill
+
+Upload files to Tencent COS bucket `octoai-1258723534`, served via `https://oss.1024code.com`.
+
+## Tool
+`coscli` — config at `~/.cos.yaml`
+
+## Bucket Info
+- Bucket: `octoai-1258723534`
+- Region: `ap-guangzhou`
+- Endpoint: `cos.ap-guangzhou.myqcloud.com`
+- Public CDN: `https://oss.1024code.com/<path>`
+
+## Upload Command
+
+```bash
+coscli cp <local-file> cos://octoai-1258723534/<remote-path>
+```
+
+### Examples
+
+```bash
+# Upload a single file to bucket root
+coscli cp /tmp/wsl.2.6.3.0.arm64.msi cos://octoai-1258723534/wsl.2.6.3.0.arm64.msi
+
+# Upload to a subdirectory
+coscli cp /tmp/install.ps1 cos://octoai-1258723534/octo-ai/octo/main/scripts/install.ps1
+
+# Upload entire directory recursively
+coscli cp /tmp/dist/ cos://octoai-1258723534/dist/ -r
+```
+
+## Public URL
+After upload, the file is accessible at:
+```
+https://oss.1024code.com/<remote-path>
+```
+
+## Steps
+1. Confirm local file exists
+2. Run `coscli cp <local> cos://octoai-1258723534/<path>`
+3. Return the public URL: `https://oss.1024code.com/<path>`

data/.octorules

@@ -0,0 +1,106 @@
+# Octo Project Rules (.octorules)
+
+## Project Overview
+This is the `octo` Ruby gem - an AI agent with three equal interfaces (CLI, Web UI, IM bridges) for interacting with AI models (Claude, OpenAI, DeepSeek, Bedrock, etc.).
+It speaks three native API protocols — Anthropic Messages, OpenAI (Chat Completions + Responses), and AWS Bedrock — dispatched per-model in `lib/octo/providers.rb`. It provides chat functionality and autonomous AI agent capabilities with tool use.
+
+## Project Structure
+- `lib/octo/` - Main gem source code
+  - `cli.rb` - Command-line interface using Thor
+  - `agent.rb` - Core AI agent with tool execution
+  - `tools/` - Built-in tools (file operations, web search, shell, etc.)
+  - `client.rb` - API client for AI models
+  - `config.rb` - Configuration management
+- `bin/` - Development executables
+- `spec/` - RSpec test suite
+- `octo.gemspec` - Gem specification
+
+## Development Guidelines
+
+### Code Style
+- Follow Ruby conventions and best practices
+- Use frozen string literals: `# frozen_string_literal: true`
+- Keep classes focused and single-responsibility
+- Use meaningful variable and method names
+- **IMPORTANT**: All code comments must be written in English
+- Add descriptive comments for complex logic
+- Use clear, self-documenting code with English naming
+- **IMPORTANT**: Always use inline `private` with instance method definitions (e.g., `private def method_name`). Do NOT use standalone `private` keyword
+- **IMPORTANT**: For class methods (`def self.method_name`), do NOT use `private`. Class methods should be public
+
+### Architecture Patterns
+- Tools inherit from `Octo::Tools::Base`
+- Each tool defines: `tool_name`, `tool_description`, `tool_category`, `tool_parameters`
+- Agent uses React pattern (Reason-Act-Observe) for task execution
+- Configuration is managed through `Octo::Config`
+- CLI commands use Thor framework
+
+### Testing
+- Use RSpec for testing
+- Test files in `spec/` directory
+- **IMPORTANT**: Always run `bundle exec rspec` to verify tests pass after making changes
+- All tests must pass before considering a task complete
+- Maintain good test coverage
+- When modifying existing functionality, ensure related tests still pass
+- When adding new features, consider adding corresponding tests
+- **IMPORTANT**: When developing new features, write RSpec tests as needed and ensure they pass
+- **DO NOT** write custom test scripts unless explicitly requested by the user
+- **DO NOT** create markdown documentation unless explicitly requested by the user
+- **IMPORTANT**: When testing octo commands or debugging, always use `bundle exec ruby bin/octo` instead of the global `octo` command. The global command loads the system-installed gem version (e.g., `openocto-0.7.0`), not your local development code
+
+### Tool Development
+**IMPORTANT**: Do NOT add new Ruby Tool classes without careful consideration. Tools are low-level primitives (file I/O, shell, web search, etc.). Before creating a new Tool, always ask: can this capability be achieved with an existing Tool + a Skill (SKILL.md) instead? If yes, use a Skill.
+
+Only add a new Tool when it requires capabilities that no existing tool can provide (e.g., a new API integration, a new system-level operation).
+
+When a new Tool is truly necessary:
+1. Create class in `lib/octo/tools/`
+2. Inherit from `Octo::Tools::Base`
+3. Define required class attributes
+4. Implement `execute` method
+5. Add optional `format_call` and `format_result` methods
+6. Require in `lib/octo.rb`
+
+### Skill Development
+Skills are the preferred way to add new high-level capabilities. A skill is a Markdown instruction file (SKILL.md) that guides the Agent to accomplish a goal using existing Tools.
+
+- Built-in default skills live in `lib/octo/default_skills/<skill-name>/SKILL.md` (shipped with the gem)
+- Project-level skills live in `.octo/skills/<skill-name>/SKILL.md`
+- User-level skills live in `~/.octo/skills/<skill-name>/SKILL.md`
+- **Prefer Skills over new Tools** whenever the task can be composed from existing primitives (write, shell, read, etc.)
+
+### Agent Behavior
+- TODO manager is for planning only - must execute tasks after planning
+- Always use tools to create/modify files, don't just return code
+- Maintain conversation context across tasks
+- Follow cost and iteration limits
+- Support different permission modes (confirm_all, confirm_edits, auto_approve, plan_only)
+
+## Dependencies
+- Ruby >= 3.1.0
+- faraday (~> 2.0) - HTTP client
+- thor (~> 1.3) - CLI framework
+- tty-prompt (~> 0.23) - Interactive prompts
+- tty-spinner (~> 0.9) - Progress indicators
+- diffy (~> 3.4) - Text diffs
+
+## Important Notes
+- This gem speaks Anthropic Messages, OpenAI (Chat Completions + Responses), and AWS Bedrock natively; provider-to-protocol mapping lives in `lib/octo/providers.rb` and message-format adapters in `lib/octo/message_format/`
+- Security features include safe shell execution and path validation
+- Agent includes cost control and message compression features
+- Built-in tools cover file operations, web search, code execution, and project management
+
+## Execution Binary
+- Development: `bin/octo` (in repository)
+- Installed gem: `octo` command globally available
+
+## Configuration
+- Stores API keys and settings in user's home directory
+- Supports multiple AI model providers
+- Configurable through `octo config set` command
+
+## Personal Rules
+1. 先想清楚，再动手 — 不确定就问，千万别猜。AI 最可怕的不是不会写，而是"自信乱写"。
+2. 能简单，就别复杂 — 只写刚好够用的代码。过度抽象，大多数时候都是技术负债。
+3. 外科手术式修改 — 需求没提到的地方，一行别碰。每次改动，都必须说得清理由。
+4. 先定义"成功" — 写代码前，先明确什么叫"完成"。否则 AI 只是在随机输出。

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,8 @@
+AllCops:
+  TargetRubyVersion: 3.1
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes

data/CHANGELOG.md

@@ -0,0 +1,76 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+This project is a hard fork of [clacky-ai/openclacky](https://github.com/clacky-ai/openclacky) at upstream **1.1.6**, renumbered as **0.10.0** in this fork's own SemVer line. Only changes made in this fork (0.11.x and later) are tracked here. For history prior to the fork, see the upstream repository.
+
+## [0.11.2] - 2026-05-25
+
+### Fixed
+- Web UI: Skills panel (`/#skills`) could not scroll when the list of skill cards exceeded viewport height. Changed `#skills-body` from `overflow: hidden` to `overflow-y: auto` to match the Channels and Trash panels.
+- Documentation: corrected Web UI port references from `7070` to `8888` in `what-is-octo.md` and `faq.md`.
+- Documentation: fixed gem install commands from `gem install octo` to `gem install octo-agent` in `installation.md` and `windows-installation.md`.
+- Documentation: updated CLI reference to include `--no-caching` and `--no-skill-evolution` flags.
+- Documentation: removed stale `deploy` skill reference from `writing-tips.md`.
+- `product-help` skill: fixed a Ruby rescue bug where `Gem::MissingSpecError` (inherits from `ScriptError`, not `StandardError`) caused the `rescue` modifier to fail when running from source. Switched to `begin/rescue Exception` with `Dir.pwd` fallback.
+
+## [0.11.1] - 2026-05-25
+
+### Added
+- Web UI: show a unified diff for the `edit` tool inline in its tool card
+- Agent: take a checkpoint snapshot right after `think()` so the Time Machine has a clean pre-tool-use anchor
+
+### Fixed
+- Web UI: a `diff` event emitted during `show_tool_preview` (before the matching `tool_call`) used to overwrite the previous tool card's stdout — typically a `read` card — making `Read(...)` look like it rendered a diff. The diff is now buffered until its owning `tool_call` creates the correct card.
+- Web UI: tool card rendering, terminal error display, and todo progress consistency
+- Web UI: keep tool groups expanded by default
+- Terminal tool: pass `handle_id` into the `run_sync` polling loop so the right task is observed
+- Terminal tool: drop the circular `max_duration` default that broke `bundle exec` startup on Ruby 3.3
+- Providers: remove fake `octo` / `octoai-sea` provider stubs and update test fixtures accordingly
+
+### Changed
+- Renamed the gem from `octo` to `octo-agent` (the `octo` name is already taken on RubyGems by an unrelated project). Repository, author, and email metadata updated to the Leihb fork.
+- Attributed the upstream `clacky-ai/openclacky` project in `LICENSE.txt` (stacked copyright) and in both READMEs (fork notice under the language switcher).
+- Documentation: README, `.octorules`, and gemspec description aligned around the "three interfaces (CLI / Web / IM), three native protocols (Anthropic Messages / OpenAI / AWS Bedrock)" framing.
+
+### Removed
+- Stopped tracking accidentally-committed gem-unpack artifacts (`data.tar.gz`, `metadata.gz`, `checksums.yaml.gz`); added anchored `.gitignore` entries so `gem unpack` at the repo root will not re-pollute the tree.
+
+## [0.11.0] - 2026-05-25
+
+First release of this fork. The hard fork happened because of philosophical disagreements with upstream over how the agent should treat human-in-the-loop interactions and long-running work; the three "headline" features below are the concrete expression of that disagreement and the reason this fork exists as a separate project. The rest of the release is rebranding and excising upstream subsystems that don't fit a non-commercial, single-brand tool.
+
+### Added
+- **Non-interrupting message inbox.** New user messages that arrive while the agent is mid-run land in a per-session inbox (`@inbox` in `agent.rb`) and are drained at the top of the next iteration, instead of preempting the in-flight tool call. This keeps tool execution atomic and ends the "user types a follow-up and the model loses its current goal" failure mode.
+- **Next-message suggestion (ghost text).** After each agent turn, the agent emits a suggested next user prompt rendered as the textarea placeholder; pressing Tab on an empty input accepts it. Bias is toward "what would a power user type now?", not toward chatty continuation.
+- **Background task notifications subsystem.** Long-running terminal tasks can be launched as background jobs; the agent is notified by the registry when they finish and resumes the conversation with the result, rather than blocking the run loop while a build/test/deploy executes.
+- Command history for both CLI and Web UI
+- `dedup_key` on background-terminal tasks to prevent the agent from spawning duplicates
+- Customizable cancel reason for background tasks
+- System-prompt guidance pushing the agent to STOP after starting an async task, and to refine async-task behavior (stop when blocked, continue when independent)
+- Forceful anti-polling instruction in the terminal "still-running" status prompt
+- Octo logo, channels panel styles, and other first-party visual assets to replace removed brand assets
+
+### Fixed
+- Anthropic thinking blocks now correctly extracted as `reasoning_content`
+- `reasoning_content` converted to Anthropic thinking blocks when emitted through third-party endpoints, so the round-trip is lossless
+- `bin/octo` entry point, banner methods, and lingering `{{BRAND_NAME}}` placeholders after rebrand
+- Terminal tool: `__CLACKY_DONE__` marker renamed to `__OCTO_DONE__`
+- Web UI: user image upload showing `[object Object]` and Analyzing-indicator ordering
+- Web UI: shared CSS that was accidentally removed during the brand/creator cleanup restored
+- CLI: logo typo corrected from `OOTO` to `OCTO`
+- Server: broadcast the background-task count immediately after a terminal kill so badges stay in sync
+- Test suite: resolved pre-existing RSpec failures in terminal and input-area specs
+
+### Removed
+- Upstream `openclacky` provider (replaced wholesale with the `octo` provider)
+- Brand module and creator hub (this fork is not a commercial / multi-brand product)
+- Billing module and the dead frontend code that fed it
+- Cost-tracking pipeline (token-usage display in the UI is preserved)
+
+## [0.10.0] - upstream baseline
+
+Hard-fork point. This version corresponds to `clacky-ai/openclacky` at upstream **1.1.6**, renumbered to 0.10.0 to start a clean SemVer line in this fork. No changes from this project are included in 0.10.0; see the upstream repository for prior history.