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.1.0 — In developmentAstro sites,
Astro sites,
from a sentence to a deploy.
Astrology brings your Astro projects, Claude Code and Codex, live preview, diagnostics, Git and deployments together in one desktop app.
Requires Node.js, npm and Git · AI features use your installed agent CLI
- 01
Project
Routes, pages and layouts
- 02
Agent
Claude Code or Codex
- 03
Preview
Your local Astro dev server
- 04
Publish
Git, build and hosting CLI
An overview of the workflow, not a screenshot of the app.
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
Start the Astro dev server and preview a page. Edit literal text and supported attributes when Astrology can map the value to a unique source location.
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. 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. You can keep using your version after that year. Renew if you want further updates; renewal pricing and purchase terms will be announced 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 in the preview?
Literal text and supported attributes, such as links and image alt text, when the value has a unique match in the source. Generated or ambiguous values cannot be changed this way; you can ask the agent to edit the underlying code.
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