Skip to content

Add /powerup interactive tutorial system#71

Merged
emal-avala merged 2 commits intomainfrom
feat/powerup-interactive-tutorials
Apr 6, 2026
Merged

Add /powerup interactive tutorial system#71
emal-avala merged 2 commits intomainfrom
feat/powerup-interactive-tutorials

Conversation

@emal-avala
Copy link
Copy Markdown
Member

Summary

  • Adds /powerup command with 5 step-by-step interactive lessons teaching core agent-code features
  • Arrow-key lesson picker with persistent progress tracking across sessions
  • Aliases: /tutorial, /learn. Direct access: /powerup 1. Reset: /powerup reset
  • Marks ROADMAP Phase 7.3 (Interactive Tutorial System) as Done

Lessons

# Title Covers
1 Your First Conversation Asking questions, @file refs, keyboard shortcuts
2 Editing Files Read/Edit/Write tools, /diff, /commit, permissions
3 Shell Commands & Tools 32 tools, ! prefix, & background, /permissions
4 Skills & Workflows 12 bundled skills, custom skills, /skill management
5 Models & Providers /model selector, /cost, /context, config.toml

Design

  • Lessons are static Lesson structs in commands/mod.rs (no new files/crates)
  • Reuses the existing selector::select() UI for the lesson picker
  • Progress stored as JSON in ~/.local/share/agent-code/powerup-progress.json
  • Each lesson returns CommandResult::Prompt(...) so the LLM drives the tutorial interactively

Test plan

  • cargo check --package agent-code passes
  • cargo test --package agent-code --bin agent — 12 unit tests pass
  • cargo test --package agent-code --test smoke — 3 smoke tests pass
  • Manual: run /powerup, select lesson 1, verify interactive flow
  • Manual: run /powerup 3 for direct access, verify lesson 3 starts
  • Manual: run /powerup reset, verify progress file is removed
  • Manual: verify completed lessons show ✔ in the picker

Implements Phase 7.3 from the roadmap: a /powerup command with
step-by-step interactive lessons that teach core agent-code features.

Lessons:
1. Your First Conversation — talking to the agent, asking questions
2. Editing Files — read, edit, create files with dedicated tools
3. Shell Commands & Tools — 32 built-in tools, ! prefix, & background
4. Skills & Workflows — /commit, /review, /test, custom skills
5. Models & Providers — switching models, cost management, config

Features:
- Arrow-key lesson picker (reuses existing selector UI)
- Persistent progress tracking (~/.local/share/agent-code/)
- Direct access: /powerup 1, /powerup 2, etc.
- Progress reset: /powerup reset
- Aliases: /tutorial, /learn
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@emal-avala emal-avala merged commit b9bc5c9 into main Apr 6, 2026
14 checks passed
@emal-avala emal-avala deleted the feat/powerup-interactive-tutorials branch April 6, 2026 07:13
@emal-avala emal-avala mentioned this pull request Apr 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant