-
Notifications
You must be signed in to change notification settings - Fork 0
feat: add interactive Learn section with embedded terminal #7
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
lua-stefan-kruger
wants to merge
1
commit into
main
Choose a base branch
from
feat/learn-interactive-tutorials
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,92 @@ | ||
| --- | ||
| title: "Lesson 1: Authentication" | ||
| description: "Set up the Lua CLI and authenticate your account" | ||
| --- | ||
|
|
||
| <Info> | ||
| **Beginner** | 5 min | Lesson 1 of 18 | ||
| </Info> | ||
|
|
||
| ## What you'll learn | ||
|
|
||
| - Run the Lua CLI | ||
| - Authenticate your account interactively | ||
| - Verify your setup works | ||
|
|
||
| ## Interactive Terminal | ||
|
|
||
| Use the terminal below to follow along. `lua-cli` is pre-installed and ready to use. | ||
|
|
||
| <iframe | ||
| src="https://stackblitz.com/edit/ssyfrbnq?embed=1&view=terminal&hideExplorer=1&hideNavigation=1" | ||
| allow="cross-origin-isolated" | ||
| style={{ | ||
| width: '100%', | ||
| height: '400px', | ||
| border: '1px solid #2a2a2a', | ||
| borderRadius: '8px', | ||
| overflow: 'hidden' | ||
| }} | ||
| /> | ||
|
|
||
| ## Step 1: Check the CLI | ||
|
|
||
| The Lua CLI is pre-installed in the terminal above. Verify it's working: | ||
|
|
||
| ```bash | ||
| lua --version | ||
| ``` | ||
|
|
||
| You should see the version number printed. | ||
|
|
||
| ## Step 2: Authenticate | ||
|
|
||
| Run the authentication command — the CLI will guide you through the process interactively: | ||
|
|
||
| ```bash | ||
| lua auth configure | ||
| ``` | ||
|
|
||
| The CLI will ask you to choose between: | ||
| - **API Key** — paste your key when prompted | ||
| - **Email OTP** — enter your email, check your inbox for the code, then enter it | ||
|
|
||
| <Tip> | ||
| **Don't have an API key?** No worries — choose the email option. The CLI will send a one-time code to your inbox. | ||
| </Tip> | ||
|
|
||
| ## Step 3: Verify | ||
|
|
||
| Once authenticated, check that everything is connected: | ||
|
|
||
| ```bash | ||
| lua agents | ||
| ``` | ||
|
|
||
| You should see your organizations and agents listed. If you're brand new, the list may be empty — that's fine! We'll create an agent in the next lesson. | ||
|
|
||
| ## Knowledge Check | ||
|
|
||
| <AccordionGroup> | ||
| <Accordion title="What command starts the authentication flow?"> | ||
| `lua auth configure` — this launches the interactive authentication wizard where you choose between API key or email OTP. | ||
| </Accordion> | ||
| <Accordion title="What are the two ways to authenticate?"> | ||
| 1. **API Key** — if you already have one, paste it when prompted | ||
| 2. **Email OTP** — the CLI sends a 6-digit code to your email | ||
| </Accordion> | ||
| <Accordion title="How do you verify authentication worked?"> | ||
| Run `lua agents` to list your organizations and agents. If it returns results (or an empty list without errors), you're authenticated. | ||
| </Accordion> | ||
| </AccordionGroup> | ||
|
|
||
| ## Next Steps | ||
|
|
||
| <CardGroup cols={2}> | ||
| <Card title="Next: Your First Agent" icon="rocket" href="/learn/your-first-agent"> | ||
| Create and configure your first AI agent | ||
| </Card> | ||
| <Card title="CLI Reference" icon="terminal" href="/cli/authentication"> | ||
| Full authentication command reference | ||
| </Card> | ||
| </CardGroup> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: "Coming Soon" | ||
| description: "This lesson is under development" | ||
| --- | ||
|
|
||
| <Note> | ||
| This lesson is currently being developed. Check back soon! | ||
| </Note> | ||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
All placeholder lessons show identical "Coming Soon" navigation titles
High Severity
All 17 placeholder lesson files use
title: "Coming Soon"in their frontmatter. In Mintlify, thetitlefield is displayed in sidebar navigation and browser tabs. This means the Learn tab's sidebar will show 17 entries all labeled "Coming Soon" with no way to distinguish between them, making the navigation completely unusable. Each page needs a unique, descriptive title (e.g., "Your First Agent", "Skills and Tools").Additional Locations (2)
learn/skills-and-tools.mdx#L1-L2learn/user-state.mdx#L1-L2