Your Astro workspace
Import a project folder or create a site from an Astro template. Keep your projects, preferred agent and deployment target together.
v0.5.0 — In developmentAstro sites at agent speed,
Astro sites at agent speed,
with studio control.
The desktop workspace for studios and freelancers who deliver Astro sites: run Claude Code or Codex on any client project, then review the page, the diagnostics and the diff before you deploy.
Requires Node.js, npm and Git · AI features use your installed agent CLI
2 agentsClaude Code and Codex CLI
3 modesPropose, Edit and Autonomous
3 hostsVercel, Netlify and Cloudflare
Features
Your everyday Astro tools, in one window
Explore your routes, work with an agent, inspect the result and follow your build and deployment output from the same workspace.
Claude Code and Codex
Chat with either installed CLI in your project folder. Choose Propose, Edit or Autonomous mode and continue the conversation with follow-up prompts.
See your site structure
Explore routes, layouts, endpoints and detected content collections. The route tree updates as files change.
Preview and edit
Switch between the live page and its highlighted Astro source. Edit and save the full file internally, or change supported literal text and attributes directly from the preview.
Ask for a change in place
A composer under the properties column hands a request to the agent without leaving the page. Context chips say which page is open and which element is selected, so the request itself can stay short.
A preview that manages itself
Opening a page starts the dev server; it stops a few minutes after the project stops being watched. A server that was already running is adopted rather than taken over.
Hand a failure to the agent
A failed build, install or publish can be passed to the agent with its whole log. The repair runs autonomously so the agent can install and rebuild, and the preview tries again once the turn ends.
Manage pages
Create, duplicate, move and delete pages. Reuse a project layout for a new page and inspect references before changing a route.
Diagnostics and translations
Find missing images, broken internal links, translation gaps and dependency issues. Use the available automatic, agent-assisted or manual remedies.
Git and GitHub
Inspect repository status, a change summary and commit history. Commit, push and pull, or create a GitHub repository through GitHub CLI.
Build and deploy
Run production builds and deploy through Vercel, Netlify or Cloudflare CLI. Preview and production actions use your host account and project configuration.
Tools and updates
Check installed tools and authentication, inspect dependency updates and upgrade blockers, and follow command output in the logs.
Working with an agent
Ask for changes in your project
Describe a page, a fix or a refactor to Claude Code or Codex. The agent works in the selected project folder. Review its output and test the result before committing or deploying.
- Choose the agent and permission mode
- Continue with follow-up prompts
- Check results in preview and build logs
---
import Layout from '../layouts/Layout.astro';
import TagList from '../components/TagList.astro';
import { getCollection } from 'astro:content';
const posts = (await getCollection('blog'))
.sort((a, b) => b.data.pubDate - a.data.pubDate);
---
<Layout title="Blog">
<ul class="posts">
{posts.map((post) => (
<li>
<a href={`/blog/${post.id}/`}>{post.data.title}</a>
<TagList tags={post.data.tags} />
</li>
))}
</ul>
</Layout>How it works
Four steps, and you keep the keys
- 01
Open or create a project
Choose a folder or an Astro template. Astrology checks the tools available on your computer and can install supported npm-based tools.
- 02
Choose the agent's permissions
Use Propose to discuss a change, Edit to let the agent write files, or Autonomous for broader command access. AI requests use the agent CLI you have configured.
- 03
Inspect the result
Follow the agent's output, check the page in live preview and inspect the Git change summary. Ask for the next change from the composer without leaving the page. Edit mode writes directly to the project; there is no mandatory per-file approval queue.
- 04
Commit and publish
Write a commit message, push to your repository, build the site and deploy through your chosen hosting CLI. Each action has its own output and status.
Questions
Before you get started
What happens after the first year?
The planned €99 Founding Members offer includes one year of updates and two active devices. You can keep using your version after that year. Renewal is planned at €99 for a further twelve months, counted from the later of today and your current update date. Purchase terms will be confirmed before sales open.
Can I open an existing Astro project?
Yes. Choose its folder to add it to the workspace. You can also create a project from a template. Astrology works on the project files in that folder.
Which AI agents can I use?
Claude Code and Codex CLI. Install and authenticate the agent you want to use. Astrology runs that CLI; it does not provide an API-key form, an included model subscription or a local-model selector.
Does the agent wait for me to approve every file?
No. Propose requests a read-only or planning session. Edit allows file changes, and Autonomous gives the agent broader command access. Inspect the results in preview and Git; file changes are not held in a separate approval queue.
What can I edit?
The Code view edits and saves the complete source file. In the visual preview, Astrology can change literal text and supported attributes, such as links and image alt text, when the value has a unique source match. Generated or ambiguous values still require the Code view or an agent.
Does my code stay on my computer?
The working files stay in your project folder, but connected tools can send data over the network. Claude Code and Codex handle AI requests according to their configuration and provider policies. Git pushes and deployments send code or build output to the selected service.
What do I need to install?
Node.js, npm and Git are required. Use a Node.js version supported by your Astro project and agent CLI. GitHub CLI and your hosting CLI are needed for their respective features. Some initial installation and login steps happen outside Astrology.
Which Astro versions and platforms are supported?
Astrology detects your project's Astro version, but a tested compatibility matrix has not been published here. The current app is built with Electron. Supported operating-system versions and download architectures will be listed with a confirmed public release.
Bring your Astro workflow together
Explore the current features and check release availability and setup requirements.
Requires Node.js, npm and Git · AI features use your installed agent CLI