diff --git a/CLAUDE.md b/CLAUDE.md
index 9729bd9..7959070 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,6 +4,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
+> **Notice:** This repository is being archived in favour of [network-agent](https://github.com/deployhq/network-agent), which has fewer dependencies and is easier to install. Both are functional during the transition period.
+
 Deploy Agent is a Ruby gem that creates a secure proxy allowing DeployHQ to forward connections to protected servers. It establishes a TLS connection to DeployHQ's servers and proxies connections to allowed destinations based on an IP/network allowlist.
 
 ## Development Commands
diff --git a/README.md b/README.md
index 177aacd..d6ed956 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
 # Deploy Agent
 
+> **Notice:** This repository is being archived. Please use [network-agent](https://github.com/deployhq/network-agent) instead — it has fewer dependencies and is easier to install.
+
 A secure proxy that allows [DeployHQ](https://www.deployhq.com/) to forward connections to servers behind firewalls. The agent establishes an outbound TLS connection to DeployHQ's servers and proxies deployment traffic to allowed destinations based on an IP/network allowlist.
 
 ## How It Works
diff --git a/deploy-agent.gemspec b/deploy-agent.gemspec
index d6f80bd..69bee90 100644
--- a/deploy-agent.gemspec
+++ b/deploy-agent.gemspec
@@ -7,7 +7,8 @@ Gem::Specification.new do |s|
   s.version     = DeployAgent::VERSION
   s.required_ruby_version = '>= 2.7'
   s.summary     = 'The DeployHQ Agent'
-  s.description = 'This gem allows you to configure a secure proxy through which DeployHQ can forward connections'
+  s.description = 'Deprecated: use https://github.com/deployhq/network-agent instead. ' \
+                  'This gem allows you to configure a secure proxy through which DeployHQ can forward connections'
   s.authors     = ['Charlie Smurthwaite']
   s.email       = ['support@deployhq.com']
   s.files       = Dir.glob('{lib,bin}/**/*')